csv ソースタグが付与され、更新されたファイルを再アップロードすると同期が維持されます。CSV インポートは、初期読み込みや一時的な更新に適しています。HR システムが継続的な信頼できる情報源である場合は、代わりに HR 同期を使用してください。
定義したカスタム属性をファイルの列として含めることもできます。Directory → Users で + User の横にある矢印を選択し、Import via CSV を選択します。
リストが変更されるたびに再アップロードしてください。CSV インポートと HR 同期は組み合わせることができます。多くのチームは CSV でディレクトリに初期データを投入し、その後 HR システムを接続して最新の状態を維持しています。HR 同期を使用すべき場合を参照してください。
ファイルの要件
列
インポートダイアログには、ファイルに含めることができるすべての列が一覧表示されます。必須のコア列、オプションのコア列、およびスキーマのカスタム属性列です。Download sample.csv のサンプルをヘッダーテンプレートとして使用してください。列名がサンプルと一致すると、各行の値はexternalId で識別されるユーザーの対応するプロファイルフィールドに入力されます。
必須
すべての行で、これらの各列に空でない値を含める必要があります。オプション
値が不要な場合は、セルを空のままにするか、列を完全に省略します。domain が空の場合、Iru はメールアドレスからそれを導出します。
カスタム属性
スキーマでカスタム属性を定義すると、インポートダイアログの Custom attribute columns にそれらが一覧表示されます。名前はカテゴリスラッグと属性スラッグからcategorySlug.attributeSlug となります。たとえば、スラッグが extrainfo のカテゴリ内の department と title は、extrainfo.department と extrainfo.title として表示されます。
CSV ヘッダーに属性ごとに 1 列を追加します。コア列名は完全に一致する必要があります。カスタム属性列名では大文字/小文字とスペースが無視されます。
サンプルファイル
インポートダイアログで Download sample.csv を選択すると、すべてのコア列と 1 人のサンプルユーザーを含むスターターファイルを取得できます。スキーマにカスタム属性が含まれている場合は、Download sample.csv の横にある矢印を選択し、With custom attributes を選択します。このサンプルにはスキーマ内の各カスタム属性の列が追加され、サンプル行のそれらのセルは入力できるよう空のままになっています。コア列とサンプルユーザーは同じです。 サンプルユーザーを独自の行に置き換え、ヘッダー名は変更しないでください。フィールドの動作
ドメインの導出
domainが空の場合、Iru はメールアドレスからそれを取得します (jane.doe@example.comはexample.comになります)。domainが指定されている場合、その値がそのまま使用されます。- まだ存在しないドメインは自動的に作成されます。
電話番号
電話番号の値は、Iru Identity の他の場所で電話番号が保存されるのと同じ方法で、E.164 (先頭の+、国コード、数字の順で、スペースや句読点なし) に正規化されます。
住所
Iru は、いずれかの住所列に値がある場合に住所を保存します。部分的な住所 (たとえばlocality と country のみ) でも問題ありません。欠落している部分は空のままです。すべての住所列が空の場合、住所は保存されません。
インポートを実行する
Import users via CSV ダイアログには、必須およびオプションのコア列、スキーマのカスタム属性列、および With custom attributes 用の矢印が付いた Download sample.csv が表示されます。ファイルをアップロード領域にドラッグするか、参照して選択します。1
インポートを開始する
Directory → Users で + User の横にある矢印を選択し、Import via CSV を選択します。ダイアログの列リストを上記の表と照らし合わせて確認します。
2
ファイルを準備する
Download sample.csv を選択して、コア列と 1 人のサンプルユーザーを含むファイルを取得します。ファイルにカスタム属性列が含まれる場合は、Download sample.csv の横にある矢印を選択し、With custom attributes を選択します。サンプルユーザーを独自の行に置き換え、各行が正しいユーザーとプロファイルフィールドにマッピングされるよう、サンプルのヘッダー名を維持します。
3
ファイルを選択する
CSV を選択するか、アップロード領域にドラッグします。
4
アップロードして検証する
Iru は最初にファイル全体を検証します。検証に合格すると、行が受け入れられ、ユーザーがバックグラウンドで作成または更新されます。検証に失敗すると、ダイアログにレポートが表示され、何もインポートされません。
5
結果を確認する
アップロードが成功すると、ステージングされたユーザー数が報告され、インポートが履歴に追加されます。履歴では各行の結果を確認できます。
作成と更新: 再アップロード
ユーザーはcsv ソース内の externalId で照合されます。
- 新しい
externalIdは、end-userロールを持つ新しいユーザーを作成します。 - 既存の
externalIdは、行からそのユーザーのプロファイルを更新します。ロールとグループメンバーシップは変更されません。
externalId は一意である必要があります。
変更した行だけでなく、毎回完全な現在のファイルを再アップロードしてください。各インポートは
externalId で照合されます。検証とエラー
検証は 2 段階で実行されます。ファイルが完全に受け入れられるまで、何もインポートされません。ファイルの問題 (ファイル全体が拒否される)
ファイルの問題 (ファイル全体が拒否される)
ファイルを処理できません。一般的な原因には、重複した列、必須列の欠落、空のファイル、データ行のないヘッダー、または制限を超える行数があります。ファイルを修正して再度アップロードしてください。
行の問題 (やはり何もインポートされない)
行の問題 (やはり何もインポートされない)
ファイルの形式は正しいものの、1 つ以上の行が無効です。Iru は、行番号 (ヘッダーが 1 行目のため、最初のデータ行は 2 行目)、問題のある列 (行全体の問題の場合は空)、およびメッセージとともにすべての問題を返します。例:
一覧表示された行を修正して再アップロードしてください。
適用エラー (正常なファイルが受け入れられた後)
適用エラー (正常なファイルが受け入れられた後)
ファイルが受け入れられた後、行はバックグラウンドで適用されます。たとえば、メールアドレスがすでに別のユーザーによって使用されている場合や、値が一意の属性と競合する場合、この段階で行が失敗することがあります。これらの適用エラーは、行の
externalId、username、エラーの詳細とともにインポートバッチに記録されます。それらの行を修正して再インポートしてください。代わりに HR 同期を使用すべき場合
リストが変更されるたびに CSV を再アップロードすると、Iru はすべての行を再チェックします。継続的で手間のかからないプロビジョニングを行うには、代わりに HR システムを信頼できる記録として接続してください。両方を使用できます。HR 同期のセットアップについては、Directory Sync で説明しています。
次のステップ
HR システムを接続する
スケジュールに従って作成、更新、削除を自動化します。
最初にスキーマを設計する
インポートする前に必須属性と一意の属性を定義します。
個々のユーザーを管理する
インポートしたユーザーを編集、一時停止、招待します。
グループに整理する
インポートしたユーザーを割り当て可能なグループにします。