社員所属のセットアップ

部門・グループに対する社員所属情報を取込みます。
取込（インポート）、および CSVへの出力（エクスポート）が可能です。
取込と出力のCSVデータのレイアウトは同一です。現在の社員所属データをCSVに出力し、Excel 等で変更後、再度、取り込む運用が可能です。

（1）取込み手順

取込（インポート）時の処理の流れを示します。

手順 項目名 説明

1

関連データの準備 *

予め、予定の組織図の登録が必要になります。予定の組織図の登録は、組織図の作成画面から登録するか、マスターインポートユーティリティの “部門のセットアップ” で登録してください。

2

CSVファイルの作成 *

取り込みデータをCSV（カンマ区切り）形式で作成します。
CSVレイアウトの詳細は、「社員所属データCSVレイアウト」を参照してください。
なお、社員所属データは、CSVに出力（エクスポート）が可能です。当システムに登録された情報をCSVに出力し、CSVを変更することで、準備作業が効率的に行えます。

3

セットアップ処理の実行 *

２で作成したCSVファイルを取り込みます。

4

セットアップ処理の完了確認 *

MIUセットアップ実行履歴画面で、実行したセットアップ処理が正常に終了したかどうかを確認します。
異常終了した場合は、エラー原因を取り除き、3 セットアップ処理 を再実行してください。

5

セットアップ結果の確認 *

組織図の変更画面にて取込みが問題なくおこなわれたか確認してください。

（2）留意事項

  • 社員所属情報の取り込みは全置換えとなります。異動など変更のない社員所属も含め、全社員の所属データを指定する必要があります。

  • 所属情報を取込む予定の組織図（部門情報）が登録されている必要があります。

社員所属データを取込む

  1. image4 ＞ MIU：セットアップ処理 をクリックします。

  2. 左ペインの image29 をクリックします。

  3. 社員所属のセットアップ画面の処理対象会社選択欄から、社員所属情報を取込む対象会社を選択します。CSVファイルに指定した会社と同じ会社を選択してください。

    image30 frame

  4. 社員所属のセットアップ画面のインポート処理欄に、取込むCSVファイルを指定します。

    image31 frame

    項目名 説明

    CSVファイル *

    image11 をクリックし、取込むCSVファイルを指定します。

    表示条件

    CSVファイル内の1行目にタイトルが挿入されている場合は、選択してください。取込む時に1行目は無視されます。

    文字コード

    CSVファイルの文字コードを指定します。

  5. image12をクリックします。

  6. image13をクリックします。
    取込み結果の確認を行います。詳細は、「実行結果の確認」を参照してください。

社員所属データを出力する

  1. image4 ＞ MIU：セットアップ処理 をクリックします。

  2. 左ペインの image29 をクリックします。

  3. 社員所属のセットアップ画面の処理対象会社選択欄から、出力する対象会社を選択します。

    image30 frame

  4. 社員所属のセットアップ画面のエクスポート処理欄から、対象の組織図を選択します。

    image32 frame

    項目名 説明

    組織図選択

    現在運用中の組織図を出力するか、作成中の予定の組織図を出力するかを選択します。
    現在運用中の組織図がない場合は、”現在の組織図” は選択できません。
    作成中の予定の組織図がない場合は、”予定の組織図” は選択できません。

    文字コード

    CSVファイルの文字コードを指定します。

  5. image12をクリックします。

  6. image6 をクリックし、出力されたファイルを保存します。

    image33 frame

バッチ処理にて社員所属データを取込む

  1. バッチファイルを作成します。
    以下を参考に、お客様の環境に合わせバッチファイルを作成してください。
    例）バッチ実行用ファイルの配置ディレクトリが「C:\tool」の場合

    java -jar C:\tool\BatchClient.jar -server http://<サーバー名>[:ポート]/pe4j -apikey <認証キー> -type <実行処理> -processTimeout <タイムアウト時間> -targetCorpId <対象会社コード> -file <CSVファイル名> -fileEncoding <文字コード> -header <タイトル行有無>

    ※上記は1行で記載します。

    ■指定するパラメタ
    項目名 説明

    http://<サーバー名>[:ポート]/pe4j *

    当システムにアクセスする際のURLを指定してください。

    認証キー *

    「バッチ実行の準備」で発行した認証キーを指定してください。

    実行処理 *

    belongimportを指定してください。

    タイムアウト時間

    バッチ処理のタイムアウト時間（秒）を指定してください。1 から 518,400 までの間で指定してください。
    未指定の場合は、21,600秒（6時間）となります。

    対象会社コード *

    「会社の登録」で登録されている会社コードを設定してください。CSVファイル内に指定した会社と同じ会社を指定する必要があります。

    CSVファイル名 *

    取り込みに使用するCSVファイルの格納先 および ファイル名をフルパスで指定してください。

    文字コード

    CSVファイルの文字コードを shift-jis または utf-8 で指定してください。
    未指定の場合は、shift-jis として取り込まれます。

    タイトル行有無 *

    1行目をタイトル行として扱うかどうかを指定します。
    1行目をタイトル行として扱う場合、true を指定します。
    1行目をタイトル行として扱わない場合、false を指定します。

    ＜サンプル＞

    java -jar C:\tool\BatchClient.jar -server http://d-circle/pe4j -apikey 19999999-a7aa-4444-9cc9-666aaa222222 -type belongimport -processTimeout 10800 -targetCorpId friend -file C:\empbelong.csv -fileEncoding utf-8 -header true

    ※上記は1行で記載します。

  2. 作成したバッチファイルを実行します。
    実行時のパラメタに問題がある場合やバッチ処理起動時にエラーが発生した場合は、コマンドプロンプトにエラーメッセージが表示され、取り込みが行われません。エラーメッセージから原因を確認のうえ、エラー原因を取り除き、再度バッチファイルを実行してください。

  3. バッチ実行が終了後、実行結果を確認します。
    正常終了時には、コマンドプロンプトに正常終了した旨のメッセージが表示されます。
    異常終了時には、コマンドプロンプトに警告 または エラーが発生した旨のメッセージが表示されます。
    実行したセットアップ処理（バッチ処理）の結果確認は、実行履歴の確認画面から行います。詳細は、「実行結果の確認」を参照してください。
    なお、異常終了した場合、警告やエラーの詳細の確認は、実行履歴の確認画面 および ログ照会画面から行います。ログ照会については、「ログ照会」の項を参照してください。

バッチ処理にて社員所属データを出力する

  1. バッチファイルを作成します。
    以下を参考に、お客様の環境に合わせバッチファイルを作成してください。
    例）バッチ実行用ファイルの配置ディレクトリが「C:\tool」の場合

    java -jar C:\tool\BatchClient.jar -server http://<サーバー名>[:ポート]/pe4j -apikey <認証キー> -type <実行処理> -processTimeout <タイムアウト時間> -targetCorpId <対象会社コード> -file <CSVファイル名> -fileEncoding <文字コード> -organizationOption <出力対象組織図>

    ※上記は1行で記載します。

    ■指定するパラメタ
    項目名 説明

    http://<サーバー名>[:ポート]/pe4j *

    当システムにアクセスする際のURLを指定してください。

    認証キー *

    「バッチ実行の準備」で発行した認証キーを指定してください。

    実行処理 *

    belongexportを指定してください。

    タイムアウト時間

    バッチ処理のタイムアウト時間（秒）を指定してください。1 から 518,400 までの間で指定してください。
    未指定の場合は、21,600秒（6時間）となります。

    対象会社コード *

    「会社の登録」で登録されている会社コードを設定してください。指定した会社コードのデータが出力されます。

    CSVファイル名 *

    出力するファイルのパス および ファイル名を指定してください。
    「\」「/」「:」「*」「?」「"」「<」「>」「|」などのOSで使用できない文字は指定できません。

    文字コード

    CSVファイルの文字コードを shift-jis または utf-8 で指定してください。
    未指定の場合は、shift-jis で出力されます。

    出力対象組織図 *

    出力対象の組織図を指定します。
    現在の組織図を出力する場合、”0” を指定します。
    予定の組織図を出力する場合、”1” を指定します。

    ＜サンプル＞

    java -jar C:\tool\BatchClient.jar -server http://d-circle/pe4j -apikey 19999999-a7aa-4444-9cc9-666aaa222222 -type belongexport -processTimeout 10800 -targetCorpId friend -file C:\EmpBelong-friend.csv -fileEncoding utf-8 -organizationOption 0

    ※上記は1行で記載します。

  2. 作成したバッチファイルを実行します。
    実行時のパラメタに問題がある場合やバッチ処理起動時にエラーが発生した場合は、コマンドプロンプトにエラーメッセージが表示され、出力が行われません。エラーメッセージから原因を確認のうえ、エラー原因を取り除き、再度バッチファイルを実行してください。

  3. バッチ実行が終了後、実行結果を確認します。
    正常終了時には、コマンドプロンプトに正常終了した旨のメッセージが表示されます。
    異常終了時には、コマンドプロンプトに警告 または エラーが発生した旨のメッセージが表示されます。
    ログ照会にて実行結果を確認します。正常終了時には出力件数、異常終了時には例外メッセージが出力されます。（出力結果が0件の場合は正常終了となります。）
    ログ照会については、「ログ照会」の項を参照してください。