ユーザーのインポート

• 適用範囲： すべてのBoardクラウドサブスクリプション

ユーザーを一括インポートし、ユーザーの詳細や権限を自動的に構成するには、インポート機能を使用します。

内容： 外部ファイルの形式と情報

ソースファイルはカンマを区切り文字として使用するCSV（カンマ区切り値）ファイルで、サイズは2048 KB未満、拡張子はfilename.csvのように、.csvでなければなりません。

ファイルの最初の行には、列ヘッダーが含まれている必要があります。 列の数は、インポートする必要がある各ユーザーの値の数と一致する必要があります。

インポートするCSVファイルを作成する場合は、次の値が推奨されます。

 

ヘッダー名	説明	使用可能な値
username	テキスト 必須値、一意でなければなりません 「ユーザープロファイル」パネルの[アカウント名(Account name)]フィールドを参照します。	すべての文字
email	メール形式のテキスト 構文：xxxxx@xxxxxxx.xxx boardauthentication = trueの場合、必須値	すべての文字
displayname	テキスト 必須値 「ユーザープロファイル」パネルの[名前(Name)]フィールドを参照します	すべての文字
phonenumber	テキスト 必須値	すべての文字
userlicense	必須値。 使用可能な値でなければなりません 「ユーザープロファイル」パネルの[ライセンス(License)]フィールドを参照します	developer		power user	user	lite			mobile	user 15
isadmin	ブール値 必須値 同じ行に指定されているプラットフォームを参照します	true				false
role	テキスト 必須値。既存のロールと一致する必要があります。 ロールはBoardプラットフォームで構成されます（「管理者」ロールは初期状態で使用可能です）	すべての文字
license	必須値。 使用可能な値でなければなりません ユーザーが複数のプラットフォームに関連付けられている場合、プラットフォームごとに1行ずつ、複数回ユーザーをインポートする必要があります。	developer		power user	user	lite			mobile	user 15
boardauthentication	ブール値 必須値	true				false
msofficeenabled	ブール値 必須値	true				false
disabled	ブール値 必須値	true				false
instancename	テキスト 必須値。 Subscription Hubに関連付けられているプラットフォームのいずれかの名前と一致する必要があります	xxxxxxxxx.board.com
culture	テキスト 必須値 構文：xx-yy（大文字と小文字を区別しない） xxは言語を識別するプライマリサブコード（例： ISO 639-1 alpha-2コードの「en」） yyは国の違いを指定する大文字のセカンダリサブコード（例：ISO 3166-1 alpha-2標準の「US」、「AU」、または「GB」） 構文の例： en-US、en-CA、es-ES、it-IT ローカライズコードとタグの一覧はこちら	xx-yy
[カスタムメタデータフィールド名]	テキスト 必須値 [ユーザーメタデータ(User metadata)]セクションの構成に従う必要があります 複数の値を入力できます。カンマで区切り、二重引用符で囲みます	Portugal（値が1つ） "Italy,Germany,Spain"（値が複数）
isshadmin	ブール値 必須値	true				false

 

注記：

• 以下の列ヘッダーは必須であり、CSVファイルに含める必要があります
  • username
  • userlicense
  • instancename
  • role
  • license
• 値が列数より少ない場合、インポートプロセスは中止され、次のエラーメッセージが表示されます：[ユーザーはインポートされません(no users will be imported)]
• 値が列数より多い場合、超過した値はすべて破棄されますが、ユーザーはSubscription Hubにインポートされます
• ライセンスで許可されている数を超えるユーザーをインポートした場合、超過したユーザーはインポートされますが、デフォルトでは無効になります
• 1人のユーザーを複数のプラットフォームに関連付ける場合、プラットフォームごとに値の行を1つ追加する必要があります。
  各行の以下のフィールド値が一致している必要があります（大文字と小文字は区別されません）。
  • email
  • userlicense
  • displayname
  • boardauthentication
  • msofficeenabled
  • phonenumber
  • culture
• 同じユーザーを複数のプラットフォームに関連付ける場合、プラットフォームライセンスは、メインユーザーのライセンス以下でなければなりません。メインユーザーのライセンスがプラットフォームライセンス未満の場合、プラットフォームのライセンスはダウングレードされ、メインライセンスと同じになります
• 同じ[email]値と[instancename]値を持つ複数のユーザーをインポートしようとすると、更新プロセスは中止され、ユーザーは更新されません
• 同じ[email]値を持つ複数のユーザーをインポートしようとすると、システムは、この値の最初の出現のみインポートします
• Subscription Hub内にすでに存在するメールアドレスと新しい[username]値を持つユーザーをインポートしようとすると、システムは、行全体のすべての情報を無視します
• 同じ[username]値と[instancename]値を持つ複数のユーザーをインポートしようとすると、システムは、この値の最初の出現のみインポートします
• CSVファイルには、Board認証以外の認証タイプを指定することはできません。 この値が「false」に設定されている場合、次に使用可能な認証タイプが適用されます
• [culture]の値は、「ユーザープロファイル」パネルの[カルチャー(Culture)]属性を定義します。 値が誤って入力された場合、または値が指定されていない場合、システムはその情報を無視して続行を試みます
• インポートプロセスが完了した後、Board認証タイプに関連付けられたすべてのユーザーは、アカウントのパスワードを設定して確定する必要があります。 これを行うには、管理者はユーザーに通知メールを送信する必要があります。通知は、[ユーザー(Users)]ホームページから一括で行うか、各ユーザーのプロファイルパネル
• インポートするカスタムメタデータがある場合、Subscription Hubでこれらのフィールドを適切に構成し、一致する列をCSVソースファイルに追加してください
• CSVファイルを使用してClient APIユーザー
• インポートプロセスによって、同期ルールの影響を受ける1つ以上のプラットフォームにユーザーが関連付けられた場合、ユーザー同期が実行されます

基本テンプレートファイルはこちらからダウンロード可能です（[カスタムメタデータ]ヘッダーは、所定のカスタムメタデータフィールド名に置き換えます。 必要に応じて、カスタムメタデータヘッダーを追加します）

 

 

CSVファイルを使用してユーザーを一括更新することもできますが、以下のアクションの実行のみ可能です。

• [email]の値を更新する（既存の値は上書きされます。 新しい値は、Subscription Hub内に既に存在するメールアドレスと同一にすることはできませんが、空にすることは可能です）。新しい値が以前の値と異なる場合、ユーザーの登録ステータスは[保留(Pending)]に変更されます。登録ステータスが[インポート済(Imported)]に設定されているユーザーは、ステータスは変更されません
• [displayname]の値を更新する（既存の値は上書きされます）
• [phonenumber]の値を更新する（既存の値は上書きされます）
• [boardauthentication]の値を変更する。 新しい値をFalseに設定すると、ユーザーの登録ステータスは[完了(Completed)]に変更されます。新しい値をTrueに設定すると、ユーザーの登録ステータスは[保留(Pending)]に変更されます。登録ステータスが[インポート済(Imported)]に設定されているユーザーは、ステータスは変更されません
• [userlicense]の値を変更する。 新しい[license]の値が使用可能な値に適合していない場合、更新プロセスにより中止され、ユーザーは更新されません。新しいメインライセンスの値がユーザーに割り当てられたプラットフォームライセンス未満の場合、プラットフォームライセンスはダウングレードされ、メインユーザーライセンスと同じになります
• [culture]の値を更新する（既存の値は上書きされます）
• [msofficeenabled]の値を変更する
• 有効値を変更する
• 既存のプラットフォームの関連付けを更新します
  • 新しいプラットフォーム名が誤って入力された場合、更新プロセスは中止され、ユーザーは更新されません
  • [isadmin]の値がTrueに設定されていて、メインユーザーライセンスが[開発者(Developer)]と異なる場合、自動的にFalse
  • 新しい[license]の値が使用可能な値と合致しない場合、システムは行全体のすべての情報を無視し、次の行に進みます。新しいメインライセンスの値がユーザーに割り当てられたプラットフォームライセンス未満の場合、プラットフォームのライセンスはダウングレードされ、メインライセンスと同じになります
  • 新しいプラットフォームライセンスの値がメインユーザーライセンスより大きい場合、プラットフォームライセンスはダウングレードされ、メインユーザーライセンスと同じになります
• 既存のユーザーをまだ関連付けられていない1つ以上のプラットフォームに関連付け、それらのプラットフォームのロールとライセンスを設定します
• カスタムメタデータを更新する（新しいインポート値がある場合は、すべてのカスタムメタデータが上書きされます）
• [isshadmin]の値を変更する

 

以下の列ヘッダーは必須であり、CSVファイルに含める必要があります

• username
• userlicense
• instancename
• role
• license

更新プロセスによって、同期ルールの影響を受ける1つ以上のプラットフォームにユーザーが関連付けられた場合、ユーザー同期が実行されます。

一括ユーザー更新用の基本テンプレートファイルは、こちらからダウンロード可能です。

 

方法： CSVファイルによるユーザーのインポート

1. ファイルからユーザーアカウントリストをインポートするには、ページの左上隅にある[インポート(IMPORT)]をクリックします
2. ポップアップで、ファイルを選択するかファイルをドラッグ&ドロップし、インポートプロセスが終了するまで待ちます。 ポップアップには、正常にインポートされたユーザーの数が表示されます

方法の説明：

• ユーザーのエクスポート