データ：ユーザーアカウント

eSuiteにデータをインポートする際、ユーザーアカウント情報が最初にインポートされる必要があります。これは、他のインポートデータがアカウントデータに依存しているためです。このデータはアカウントファイルをインポートすることで提供されます。

ユーザーアカウントデータの更新

アカウントデータの差分更新（Delta）を行う際は以下のロジックが使用されます。

インポートするデータのユーザーキーをもったデータが存在しない場合、新規にデータが作成されます。
ユーザーキーをもったデータがすでに存在している場合、そのアカウントデータは更新されます。インポートするデータの項目に値が設定されている場合、その値は上書きされます。値が設定されていない項目は、更新されません。空白にする場合は「{blank}」を設定する必要があります。

アカウントのパスワード

アカウントファイルのユーザーパスワード欄は、eSuiteがユーザー認証を行うのかどうか、ユーザーアクセスはClientUserIdで処理するのかどうかによってお客様が用意する必要があります。ハッシュ関数、ソルト、ソルトの位置についても考慮する必要があります。

サポートされているメカニズム

eSuiteでは以下のハッシュ関数をサポートしています。

MD5
SHA1*
SHA256*
SHA512*
BCrypt

*PBKDF2を使用している場合、パスワードの提供に関する説明についてはこちらをクリックしてください。

ソルトの位置

ソルトの位置はパスワードの前、後、どちらにも対応しています。SaltPositionの列に指定してください。

ソルトがパスワードの前にくる場合、left
ソルトがパスワードの後にくる場合、right

セキュリティの観点からソルト無しのパスワードは推奨されませんが、SaltPositionの列を空白にすることでソルト無しのパスワードを設定することは可能です。

ClientUserIdとEmail

ClientUserIdがプライマリキーとして使用される場合、パスワードの設定は必要ありません。メールアドレスがプライマリキーとして使用される場合は、パスワードを設定する必要があります。パスワードの暗号化メソッドについてeSuiteに連絡し、メソッドがサポートされるようにする必要があります。
Note: ClientUserIdはユーザーアカウントのユニークIDとする為、値は変更出来ません。そのため、クライアントは、提供される値が各ユーザーごとにユニークで変更されないようにする必要があります。

その他のオプション

パスワードの項目を平文の形で出力できない場合、パスワード項目は空白にする必要があります。その際、eSuiteが新しいパスワードをランダムで生成します。マーケティングメールを送信して、パスワード再設定の必要性をユーザーに連絡する必要があります。この連絡はeSuiteのパスワードを忘れた場合機能を使用するか、UserAmendのAPIコールを呼ぶことで行えます。

ユーザーアカウント・ファイル仕様

ユーザーアカウントのファイル仕様は以下のとおりです。

カラム名	詳細	説明
KeyField	必須：Yes フォーマット：E \| C 入力規則：上記の値のいずれかである必要がある。大文字/小文字：区別しない	E = メール C = クライアントユーザーID
Email	必須：Yes_Alt フォーマット：Unicode文字列（最大255文字）入力規則：長さ、一意、正規表現メール大文字/小文字：区別しない。保持するために小文字にキャストします。	ユーザーのメールアドレス。有効なメールフォーマットである必要があります。eSuiteがユーザー認証のマスターである場合、本値を提供し、本値は固有である必要があります。値が他のアカウントのメールと同じ場合、インポーターは挿入ではなく更新を行います。
ClientUserId	必須：Yes_Alt フォーマット：Unicode文字列（最大50文字）入力規則：長さ、一意大文字/小文字：大文字と小文字が保持されます。固有性テストでは小文字にキャストされます。	ユーザーアカウントのサードパーティシステムのID（eSuiteがアカウント認証のマスターでない場合）。
PasswordHashMethod	必須：No フォーマット：MD5 \| SHA1 \| SHA256 \| SHA512 \| BCrypt \| 空欄入力規則：上記の値のいずれかと一致するか空欄である必要がある。大文字/小文字：区別しない。	デフォルトで使用可能なハッシュ関数以外の使用を希望する際は、ファイルの提出前にアカウントマネージャーにご相談ください。
PasswordSalt	必須：No フォーマット：Unicode文字列（最大20文字） \| { 空欄 } 入力規則：長さ、大文字、HEX(hexadecimal)	例：E4A67FB230AD12AF
SaltPosition	必須：No フォーマット：L \| R \| { 空欄 } 入力規則：L、R、または空欄	「L」が指定された場合、パスワードの左側にソルトが追加されます。「R」が指定された場合、パスワードの右側にソルトが追加されます。その他の連結方法によるソルトパスワードの設定については、ファイル提出前に担当のアカウントマネージャーにご相談ください。
Password	必須：No フォーマット：Unicode文字列（最大150文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。パスワードチェックは大文字と小文字を区別します。	ユーザー認証用パスワード。 eSuiteをユーザー認証のマスターに使用しない場合、必要ありません。 eSuiteをユーザー認証のマスターに使用する際にこの項目が空だった場合、eSuiteが自動で生成します。
Title	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：種類	ユーザーの敬称。利用可能な値：50文字以内であれば、何でも可能です。
FirstName	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの下の名前。
LastName	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの姓。
DOB	必須：No フォーマット：YYYY-MM-DD 入力規則：過去の日付である必要があります。大文字/小文字：大文字と小文字が保持されます。デフォルト：1900-01-01	ユーザーの生年月日。
Gender	必須：No フォーマット：文字列 (1) 大文字/小文字：大文字デフォルト：U	ユーザーの性別。男性（M）、女性（F）、未指定（U）。利用可能な種類：M、F、U
AccountVerified	必須：No フォーマット：1または0 入力規則：なしデフォルト：0	アカウントが他のシステムで認証されたかどうか。
MarketingInformation	必須：No フォーマット： 1または0 入力規則：なし大文字/小文字：大文字と小文字が保持されます。デフォルト：0	ユーザーがマーケティングメールの受信を希望しているかどうか。
HomePhone	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	国コードがイギリスの場合のみ、形式をバリデートします。
MobilePhone	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	国コードがイギリスの場合のみ、形式をバリデートします。
HouseFlatNumber	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。通常は数値です。
HouseFlatName	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
Street	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
TownCity	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
District	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
County	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
State	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。（米国のみ）
PostCode	必須： No フォーマット：Unicode文字列（最大20文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
Country	必須：No フォーマット：Unicode文字列（最大50文字）入力規則：長さ大文字/小文字：大文字と小文字が保持されます。	ユーザーの住所の一部。
AccountDetail_[Name]	必須：No フォーマット：Unicode文字列（最大255文字）入力規則：カスタムスキーマ拡張子で事前定義する必要があります。事前定義されていない場合、データ検証は失敗します。大文字/小文字：大文字と小文字が保持されます。	[Name]の部分をインポートするアカウント情報の項目名に置換。項目が存在しない場合はエラーになります。この項目は複数列指定することができます。