目次

3.【ディレクトリ】インポート用ディレクトリ台帳CSVの作成方法

MiuraYuto 更新 by MiuraYuto

推奨環境と前提条件

Adminaでは、以下の環境・形式でのCSVインポートを推奨しています。

・文字コード：UTF-8

・ファイル形式：CSV (コンマ区切り) (.csv**) 形式

・ファイル名：環境依存文字（旧字体、特殊記号など）や半角カタカナのご使用はお控えください。

　　

ディレクトリ台帳をCSVでインポートする

テンプレートをExcelで開く場合、アプリケーション側の問題で文字化けする場合がございます。文字化けの解決方法は各種Webサイトやこちらをご確認ください。解決しない場合、Excel以外のアプリケーションをご利用ください。
  1. ディレクトリ > インポートに進み、テンプレートをダウンロードします。
    「エクスポート」から既存データをCSV出力後、インポートすることも可能です。
  2. 管理したい項目をテンプレートに沿って成形します。
  3. テンプレートをインポートして完了です。

　　　

CSVインポートの注意点
  • 機種依存文字はサポート対象外です。
  • 一度のインポートで登録可能な件数は1,000件までです。
CSVインポートで更新したディレクトリ情報が、SaaSとの日次同期により更新される場合があります。日次同期で更新不要の項目はディレクトリ設定のデータソースを「Admina」に設定してください。詳細は「ディレクトリ設定」でデータソースを設定・変更するをご参照ください。

　　　

CSVインポートによるデータ上書き

CSVインポート時における既存データは上書きされます。以下注意点を列挙いたしますので、必ずご確認ください。　

  • CSVアップデートによる上書きを実施する前に必ずバックアップデータをエクスポートしてください。データの復旧はできません。
  • Adminaに存在するデータをCSVのデータが上書きをする処理になります。CSVのデータが空白の場合、空白でデータの上書きがされます。
  • アカウントデータを部分的に修正する場合、変更部分のみをを修正ください。変更しない部分の列を消したりせず、データが存在する状態でインポートください。（項目列を消した場合、空白で上書きされます）
  • 変更したくないアカウント情報がある場合、アカウントの対象行を削除することを推奨します。

　　

CSVインポートを用いた"ID種別：未管理ID 及び ステータス：未監視"への一括編集について
ID種別：未管理IDに変更した場合でも、ステータス：下書きとなっている場合、従業員マスタを同期した段階で、ID種別とタイプが従業員マスタに準じて変更されます。
変更したくない場合、ステータス：未監視にする必要がありますので、employeeStatusの変更が必要です。
  1. ディレクトリ > エクスポートから、CSVデータのエクスポートを行います。
  2. CSVデータで変更する従業員データのみ残し、その他の行を削除します。
  3. 下記のように該当データを変更する
    employeeType : unregistered
    managementType : unregistered
    employeeStatus : untracked
  4. ディレクトリ > インポートから、CSVデータのインポートを行います。

　　　　　

登録テンプレート

以下、テンプレートを利用して情報登録できる項目及び仕様になります。

項目名

必須/任意

入力例

入力仕様

ID

任意/必須

空白 or 英数字10桁

新規登録時：空白（Adminaが自動生成します）

編集時：エクスポート時に10桁の値が入っています

emplyeeID

任意

CODE111

社員ID

employeeType

必須

full_time_employee

タイプ (英語のパラメータをご指定ください)

・役員→board_member

・正社員→full_time_employee

・契約社員→fixed_time_employee

・派遣従業員→temporary_employee

・パート従業員→part_time_employee

・出向従業員→secondment_employee

・契約従業員→contract_employee

・コラボレーター→collaborator

・グループアドレス→group_address

・共用アドレス→shared_address

・テストアドレス→test_address

・その他→other

・不明→unknown

・未管理（ID種別が未管理IDの場合のみ）→unregistered

management Type

任意

managed

ID種別（エクスポートデータのみ）英語のパラメータをご指定ください

・社内ID→managed

・外部ID→external

・システムID→system

・不明ID→unknown

・未管理ID→unregistered

employeeStatus

必須

active

ステータス（英語のパラメータをご指定ください）

・就業中→active

・休職中→on_leave

・下書き→draft

・入社前→preactive

・退職済→retired

・未監視（ID種別が未管理の場合のみ指定可）→untracked　

・アーカイブ（SaaSやデバイスが0件の時のみ→archived

firstName

任意

太郎

名

lastName

任意

木村

姓

displayName

必須

木村 太郎

表示名

primaryEmail

任意

a@a.com

プライマリメールアドレス

secondaryEmails

任意

a+1@a.com; a+2@a.com

セカンダリメールアドレス。複数入力するときは”;"で分けます。

avatar

任意

http://a.image.com

アバターのURL

jobTitle

任意

マネージャー

職種

companyName

任意

株式会社マネーフォワード

会社名

workLocation

任意

東京

場所

lifecycleContractStartAt

任意

2022-08-09

勤務開始日（yyyy-mm-dd)

lifecycleContractEndAt

任意

2025-08-09

勤務終了日（yyyy-mm-dd)

lifecycleSuspensionStartAt

任意

2023-08-09

休職開始日（yyyy-mm-dd)

lifecycleSuspensionEndAt

任意

2023-11-15

休職終了日（yyyy-mm-dd)

departmentName

任意

カスタマーサクセス部

部署名

managerName

任意

山本 次郎

上長名

Note

任意

インターンから正社員に

メモ

　　　

FAQ

Q. CSVファイルのインポートが行えない場合、何を確認したら良いでしょうか？

A. 【CSVインポート】推奨環境とエラー発生時の対処法をご参照ください。

この記事はお役に立ちましたでしょうか？

2.自主管理のIDを特定する

4.【ディレクトリ】管理項目のカスタマイズ

お問い合わせ