ユーザーの一括アップロード時に発生する問題に関するトラブルシューティングのヒント | アドビAdmin Console

ユーザーのインポート（一括アップロード）機能を利用すると、企業の管理者はユーザー ID から構成されるファイルを作成し、企業顧客管理者ユーザー管理ページに送信し、処理できます。ファイルの各エントリはユーザーを表し、処理の結果はユーザーごとのアカウントによって作成されたものです。数千単位のアカウントが存在することがあり、その状態と処理の進捗が表示されます。ファイルの処理をいつでもキャンセルできます。

指定のライセンス数だけ各種アドビ製品を利用できるアドビライセンス契約をお客様が購入すると、企業アカウントが作成されます。購入処理が完了すると、アドビの代理人が組織のアカウントを作成し、そのアカウントを管理できるユーザーを作成します。その管理者は組織のメンバーのユーザーアカウントを作成し、管理できます。

機能

ファイルを処理対象として選択すると、次の事前チェックが行われ、不合格の場合、エラーメッセージが発行されます。

• CSV 形式のファイル
• 合法的であること（ヘッダーがある場合）
• 1 ～ 5000 エントリ

エントリごとに：

• 電子メールアドレスが合法であること
• ゼロ以上の指定された製品構成
• 国が合法であること（存在する場合）およびアドビが事業を行う国であること
• オプションが合法であること（存在する場合）

ファイルにつき最大 5000 エントリを 1 回のインポート操作で処理できます。

ファイルが処理されると、各エントリは次のように個別に処理されます。

すべてのファイルエントリの処理が完了すると、処理を開始したユーザー宛ての電子メールメッセージが生成され、完了と結果の概要が通知されます。

インポート操作がキャンセルされた場合、処理は速やかに停止されます。 完了した処理はロールバックされません。

ユーザーインターフェイス

管理コンソールの［ユーザーの一覧表示］パネルにはユーザーファイルをアップロードするためのアイコンがあります。ファイルの種類は「csv」であり、「.csv」という接尾辞が付きます。その形式は以下のようになります。

インポートを選択すると、指示やサンプルファイルをダウンロードするためのリンク、およびファイルのアップロードや処理を行うファイルを閲覧し、選択するためのリンクを含むダイアログが表示されます。

処理するファイルを選択すると有効性の事前チェックが行われ、検出されたエラーが報告されます。エラーがなければ、ファイルはサーバーに保存され、処理が開始します。（ドメインに関係なく）所与の組織に対して実行できるインポート操作は 1 回だけになります。そのため、インポート操作を続けて開始しても最初の操作が完了するまで無効になります。

処理が承認されると、「ユーザーの一覧表示」パネルの「インポート結果」タブに行が表示されます。エントリには、次のものが表示されます。

• ファイル名
• アップロードおよび処理開始の日付/時刻
• 状態（処理中/完了/取り消し）（定期的に更新）
• 作成されたアカウントの数（定期的に更新）
• エラーの数（定期的に更新）
• 処理レート（エントリ/秒）（定期的に更新）
• 残り時間の概算（定期的に更新）
• 操作のキャンセル制御（処理が進行中の場合のみ）
• レポートへのリンク（処理が完了したとき）
• エントリの削除制御（処理が完了したとき）

ファイル名をクリックすると、状態が「完了」または「取り消し」となったときの処理の詳細がポップアップレポートに表示されます。 成功および各種の失敗を含む合計カウントが表示されます。ゼロ以外の値が表示されます。

処理の進捗に伴い、作成されたユーザーがアクティブユーザーリストに表示されます（あるいは、カウントを表示している場合、カウントが更新されます）。

処理の進捗に伴い、生成されたユーザー招待が保留招待リストに表示されます（または、カウントが表示されている場合はカウントが更新されます）。

処理が完了するとレポートが生成され、処理されたエントリごとに結果が表示されます。 レポートには列が 3 つあります。

• ライン番号
• 電子メールアドレス
• 状態とエラーメッセージ（エラーがあれば）

レポートはライン番号順に並べ替えられます。ライン番号は csv ファイルの元のライン番号に対応します。

重要：「インポート結果」ページには、90 日以内のレポートが表示されます。90 日を超えて経過したレポートは、システム管理者の介入なしに自動的に削除されます。

ファイル形式

ユーザーを一覧表示するファイルは、RFC 4180 （CSV ファイル仕様）に準拠する必要があります。 見出し行が存在する場合、次のいずれかになります。

Type、Email、ProductConfigurations、user name、CountryCode、FirstName、LastName、Options

注：これらのフィールドは定期的に変更されることがあります。ヘッダーがAdmin Consoleからの最新サンプルと一致することを確認します。

これらのフィールドは次のように定義されます。

一括アップロードのトラブルシューティング

このセクションでは、アドビAdmin Consoleの一括インポート機能の利用時に発生するエラー状況などの問題を解決する際に役立つ情報を提供します。

「無効な構成名」エラー

「無効な構成名」（「INVALID_CONFIGURATIONS」）というエラーが表示される場合は、Admin Consoleで製品構成を確認します。

• 製品構成が「デフォルト構成」の場合、これは一例として表示される仮想の構成です。この構成を編集して実際の作業製品構成に変換する必要があります。
• 新しい製品構成を作成すると、「デフォルト設定」は非表示になります。
• 製品構成の編集後に、または新しい構成の作成後に、一括インポートを再試行してください。

CSV 形式の検証

CSV ファイルをダッシュボードのサンプルテンプレートと比較し、そのファイルの有効性を検証します。重要なフィールドは名、姓、ユーザー ID、電子メールアドレス、国コードです。

ユーザーが存在していてもインポートは失敗しません。 その代わり、ユーザーがすでに存在しているというメッセージが一括アップロードレポートに表示されます。

アップロードレポートには、既存のユーザー警告とは別に他のエラーが一覧表示されます。

各種ユーザー ID の必須フィールド:

既知の問題

現在のところ、一括インポートレポートのインポートエラーメッセージは右側で切り詰められます。この問題はAdmin Consoleの将来のバージョンで修正される予定です。

インポートエラー状況、メッセージ、応答コード

一部の特殊な事例:

パフォーマンス詳細

過負荷を回避するために、66.6% の負荷サイクルルールが処理に含まれます。エントリを処理する時間が 10% 以上周期的平均と離れている場合、要求の処理で実時間の 2/3 だけが使用されるようにスロットルが調整されます。

さらに、操作チームが管理するスロットル制御により処理レートが制限されます。スロットル制御が明示的に設定されている場合、負荷サイクル制御は無効になります。 負荷サイクル基準のスロットル制御に戻す API 呼び出しがあります。

1 秒間に処理される要求の数がパフォーマンスに関するフィードバックとして表示されます。

1000 アカウントを作成し、それぞれ 2 つの製品構成に追加する場合、ターゲットレートは毎秒 1 アカウントで、66.6% の負荷サイクルは考慮しません。そのため、見かけの処理レートは毎秒 0.66 アカウントまたは毎分 40 アカウントとなります。このレートで 1000 アカウントを作成するには 25 分かかります。 このレートで 5000 アカウントを作成するには 2 時間 5 分かかります。