推奨環境と前提条件
以下の環境・形式でのCSVインポートを推奨しています。| 項目 | 内容 |
|---|---|
| 文字コード | UTF-8（UTF-8 BOM + CRLF） |
| ファイル形式 | CSV (コンマ区切り) (.csv) 形式 |
| ファイル名 | 環境依存文字（旧字体、特殊記号など）や半角カタカナのご使用はお控えください。 |
ディレクトリ台帳をCSVでインポートする
-
ディレクトリ > インポートに進み、テンプレートをダウンロードします。「エクスポート」から既存データをCSV出力後、インポートもできます。
- 管理したい項目をテンプレートに沿って成形します。
- テンプレートをインポートして完了です。
CSVインポートの注意点
既存データはCSVインポート時に上書きされます。以下に注意点を列挙いたしますので、必ずご確認ください。| 項目 | 内容 |
|---|---|
| バックアップ | CSVで上書きする前に、必ずバックアップデータをエクスポートしてください。データの復旧はできません。 |
| 既存データの上書き | 既存データをCSVのデータが上書きする処理になります。CSVのデータが空白の場合、空白でデータの上書きがされます。 |
| 部分的に修正する場合 | 部分的に修正する場合、変更部分のみを修正してください。変更しない部分の列を消したりせず、データが存在する状態でインポートしてください。（項目列を消した場合、空白で上書きされます） |
| 変更したくない情報がある場合 | 変更したくないアカウント情報がある場合、アカウントの対象行を削除することを推奨します。 |
| 機種依存文字 | サポート対象外です。 |
| 登録可能な件数 | 一度のインポートで登録可能な件数は1,000件までです。 |
| 日次同期 | CSVインポートで更新したディレクトリ情報が、SaaSとの日次同期により更新される場合があります。日次同期で更新不要の項目はディレクトリ設定のデータソースを当サービスに設定してください。詳細は「ディレクトリ設定」でデータソースを設定・変更するをご参照ください。 |
CSVインポートを用いた”ID種別：未管理ID 及び ステータス：未監視”への一括編集について
ID種別：未管理IDに変更した場合でも、ステータス：下書きとなっている場合、従業員マスタを同期した段階で、ID種別とタイプが従業員マスタに準じて変更されます。
変更したくない場合、ステータス：未監視にする必要がありますので、employeeStatusの変更が必要です。
- ディレクトリ > エクスポートから、CSVデータのエクスポートを行います。
- CSVデータで変更する従業員データのみ残し、その他の行を削除します。
- 下記のように該当データを変更します。
employeeType→unregisteredmanagementType→unregisteredemployeeStatus→untracked
- ディレクトリ > インポートから、CSVデータのインポートを行います。
登録テンプレート
以下、テンプレートを利用して情報登録できる項目及び仕様になります。| 項目名 | 必須/任意 | 入力例 | 入力仕様 |
|---|---|---|---|
| ID | 任意/必須 | 空白 or 英数字10桁 | 新規登録時：空白（自動生成します） 編集時：エクスポート時に10桁の値が入っています |
| employeeID | 任意 | 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 |
| managementType | 任意 | 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 | 任意 | user@example.com | プライマリメールアドレス |
| secondaryEmails | 任意 | user+1@example.com; user+2@example.com | セカンダリメールアドレス。複数入力するときは”;“で分けます。 |
| avatar | 任意 | http://example.com/image.png | アバターのURL |
| jobTitle | 任意 | マネージャー | 職種 |
| companyName | 任意 | 株式会社Example | 会社名 |
| 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 | 任意 | インターンから正社員に | メモ |