属性マッピング設定
ここでは、インポートAPIなどで指定するCSV情報の記載内容を定義する設定値について、説明します。
options/mapping設定値
「options」内で定義される「mapping」オプションでは、同じAPIに設定されるCSV情報の項目と本サービスの属性とのマッピング設定を指定します。
【参考】
設定例などに記載がない「本サービスの属性ID」について詳しくは、「属性ID一覧」をご覧ください。
凡例
[本サービスの属性ID]: [CSV情報の項目名]
記載例
organization: 組織 project: プロジェクト
別項目での複数設定
複数の会社、組織、事業所、プロジェクトを設定する場合は、以下のように会社、組織、事業所、プロジェクトの項目の後に「{ref}」を記載します。
記載例
organization: 所属組織 {ref}
複数の所属先が、以下のような連番つきの項目としてマッピングされます。
| CSV項目名 | マッピング内容 |
|---|---|
| 所属組織 1 | 所属する1つ目の組織 |
| 所属組織 2 | 所属する2つ目の組織 |
別項目での階層表現
会社、組織、事業所、プロジェクトは階層構造にできます。1つの項目を設定するときに、以下のように会社、組織、事業所、プロジェクト項目の後に「{tier}」を記載して、階層ごとの名前を指定します。
【注意】
CSV上では複数の項目で記載されますが、設定される会社、組織、事業所、プロジェクトは1つのみです。
記載例
organization: 所属組織 {tier}
階層ごとの会社、組織、事業所、プロジェクト名が、以下のような連番つきの項目としてマッピングされます。
| CSV項目名 | マッピング内容 |
|---|---|
| 所属組織 1 | 所属する組織の第1階層組織名 |
| 所属組織 2 | 所属する組織の第2階層組織名 |
CSVの内容に応じた設定例
複数の会社、組織、事業所、プロジェクトを登録する場合は、APIの「option」設定として指定できる以下の項目を必要に応じて設定することで、様々な形式のCSV情報を読み込めます。
【注意】
- 複数の会社、組織、事業所、プロジェクトを指定する際は、それぞれの会社、組織、事業所、プロジェクトにおける属性情報も同じ形式で記載する必要があります。設定内容について詳しくは、後述する設定例をご覧ください。
- 後述の設定例では、設定項目に関連する項目のみを記載しています。実際のAPI実行に必要な項目について詳しくは、「API一覧」をご覧ください。
| options設定値名 | 設定内容 |
|---|---|
| mapping | 詳しくは、「options/mapping設定値」をご覧ください |
| referenceSeparator | 同一セルに複数の会社、組織、事業所、プロジェクトを記載する際の区切り文字 |
| tierSeparator | 同一セルに階層ごとの情報を記載する際の区切り文字 |
設定例で利用する情報
ここでは、設定例で利用する組織について記載します。
【注意】
ここでは、例示に利用される項目のみを記載しています。
本サービスでは、「役職」以外の属性情報や、以下の表にない「役職」を利用することも可能です。
組織構成
| 第1階層 | 第2階層 | 第3階層 |
|---|---|---|
| 株式会社〇〇 | □□部 | □□1課 |
| □□2課 | ||
| △△部 | △△1課 | |
| △△2課 |
属性情報
| 属性情報名 | 設定値 |
|---|---|
| 役職 | 組織長 |
| メンバー |
1つのセルに所属組織の階層ごとの情報と、所属している複数の組織を両方とも記載している場合
CSV情報
| メールアドレス | 所属組織 | 役職 |
|---|---|---|
| iij-taro@example.jp | 株式会社〇〇/□□部/□□1課 株式会社〇〇/△△部/△△2課 | 組織長 メンバー |
options設定
| 項目名 | 設定値 |
|---|---|
| mapping | email: メールアドレス\norganization: 所属組織 |
| referenceSeparator | （半角スペース） |
| tierSeparator | / |
1つのセルに所属組織の階層ごとの情報を記載し、所属組織ごとに項目が分かれている場合
CSV情報
| メールアドレス | 所属組織1 | 所属組織2 | 役職1 | 役職2 |
|---|---|---|---|---|
| iij-taro@example.jp | 株式会社〇〇/□□部/□□1課 | 株式会社〇〇/△△部/△△2課 | 組織長 | メンバー |
options設定
| 項目名 | 設定値 |
|---|---|
| mapping | email: メールアドレス\norganization: 所属組織 {ref}
|
| referenceSeparator | (未設定) |
| tierSeparator | / |
同一の従業員の所属情報が複数行に分かれている場合
CSV情報
| メールアドレス | 所属組織 | 役職 |
|---|---|---|
| iij-taro@example.jp | 株式会社〇〇/□□部/□□1課 | 組織長 |
| iij-taro@example.jp | 株式会社〇〇/△△部/△△2課 | メンバー |
options設定
| 項目名 | 設定値 |
|---|---|
| mapping | email: メールアドレス\norganization: 所属組織 |
| referenceSeparator | (未設定) |
| tierSeparator | / |