付加情報連携

概要

CSVファイルを利用した付加情報の一括変更について記載します。CSVファイルを利用することでユーザ・グループの付加情報(namespaceとid)を変更することができます。詳細は SmartDB システム管理者ガイド を参照してください。

連携方式

手動連携

管理画面  アカウントマスタ連携  付加情報連携  CSV入力 から手動で付加情報の一括変更を実施することができます。

  • 管理画面  アカウントマスタ連携  CSV連携  CSV入力 によるアカウントマスタの手動連携、又はWebAPIによる自動連携中は、付加情報連携を実施することはできません。

CSV定義

CSV連携には連携対象により、2種類のCSVファイルがあります。各CSVファイル定義をよく確認し、付加情報連携を実施してください。

ファイル仕様

デリミタ

, (半角カンマ)

文字コード

UTF-8

ヘッダー

有り

ユーザ付加情報(user_ext_ids.csv)

ユーザのnamespace、idを変更するためのCSVファイルです。

  • CSVファイルに含まれているかつ、変更後のnamespace, id(new_namespace、new_id)が記載されているユーザのみ変更の対象となります。

user_ext_ids.csv
必須 キー 説明 フォーマット

namespace

名前空間(任意の文字列)

半角英数-_

JinjiSystem

id

ユーザの識別キー(名前空間内で一意な識別子)

半角英数-_

u000001

new_namespace

新しい名前空間(任意の文字列)

半角英数-_

JinjiSystem

new_id

新しいユーザの識別キー(名前空間内で一意な識別子)

半角英数-_

u000001

mid(read only)

SmartDB内部の識別子(編集不可)

1から始まる7桁の数字

1000013

login_id(read only)

ログインID(メールアドレス)

文字列

xxx@hoge.com

name(read only)

ユーザ名(日本語)

文字列

ドリーム 太郎

primary_gname(read only)

プライマリ所属組織名(編集不可)

文字列

営業部

  • new_namespace と new_id は合計して91文字以下にする必要があります。

  • mid(read only)、name(read only)、primary_gname(read only)カラムは、CSV出力時に付加される参照用のカラムとなり、CSV入力時には不要なカラムとなります。CSV入力時に該当カラムが存在している場合、該当カラムは処理の対象とはならず、カラムが存在していないものとして扱われます。

  • サンプル

namespace,id,new_namespace,new_id,mid(read only),login_id(read only),name(read only),primary_gname(read only)
smartdb,1000012,JinjiSystem,u000101,1000012,h_dream@example.com,ドリーム 花子,業務部
JinjiSystem,u000102,,,1000013,t_dream@example.com,ドリーム 太郎,情報システム部

グループ付加情報(group_ext_ids.csv)

グループのnamespace、idを変更するためのCSVファイルです。

  • CSVファイルに含まれているかつ、変更後のnamespace, id(new_namespace、new_id)が記載されているグループのみ変更の対象となります。

group_ext_ids.csv
必須 キー 説明 フォーマット

namespace

名前空間(任意の文字列)

半角英数-_

JinjiSystem

id

グループの識別キー(名前空間内で一意な識別子)

半角英数-_

g000001

new_namespace

新しい名前空間(任意の文字列)

半角英数-_

JinjiSystem

new_id

新しいグループの識別キー(名前空間内で一意な識別子)

半角英数-_

g000001

gid(read only)

SmartDB内部の識別子(編集不可)

2から始まる7桁の数字

2000013

name(read only)

名称(日本語)

文字列

営業部

parent_name(read only)

親組織名(編集不可)

文字列

営業本部

  • new_namespace と new_id は合計して91文字以下にする必要があります。

  • gid(read only)、name(read only)、parent_name(read only)カラムは、CSV出力時に付加される参照用のカラムとなり、CSV入力時には不要なカラムとなります。CSV入力時に該当カラムが存在している場合、該当カラムは処理の対象とはならず、カラムが存在していないものとして扱われます。

  • サンプル

namespace,id,new_namespace,new_id,gid(read only),name(read only),parent_name(read only)
smartdb,2000011,JinjiSystem,g000001,2000011,業務部,業務本部
JinjiSystem,g000002,,,2000012,営業部,営業本部