一括追加の概要

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

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

注意:

ユーザーのインポート機能は、カンマ(,)やセミコロン(;)などの特殊文字を含むユーザーのニックネームをサポートしません。

機能

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

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

エントリごとに:

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

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

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

電子メールアドレスドメインは

アクション

例外

組織が要求し、アドビが管理 Adobe ID アカウントは、指定されたメールアドレスを使用して作成されます。歓迎のメールが送信されます。

すでに招待が進行中であるか、または指定した電子メールのアカウントが存在します。

表示される場合、アドビが事業を展開する国ではありません。

製品構成が違法であるか、割り当てが超過しています。

組織が要求し、企業が管理 指定したユーザー名で個人レコードが作成されます。指定された製品構成に追加します。ドメインの決定以外では電子メールアドレスは使用されません。電子メールは送信されていません。

ユーザー名が存在します。

表示される場合、アドビが事業を展開する国ではありません。

製品構成が違法であるか、割り当てが超過しています。

組織は要求していません

ユーザーの電子メールアドレスに招待メールを送信します。アカウントは作成されていません。その招待は、リストされている製品構成に関連付けられています。

アカウントが存在する場合は、製品構成に追加します。

指定の電子メールの招待またはアカウントはすでに存在します。

表示される場合、アドビが事業を展開する国ではありません。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ファイル形式

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

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

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

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

フィールド

構文

解釈

種別 Adobe ID、Enterprise ID、Federated ID のいずれかの値。 これらの値により、ユーザーに割り当てられた ID の種類が制御されます。大文字と小文字の区別をしません。ID の種類はドメインに対して有効である必要があります。
電子メール

RFC 2822 sec 3.4.1

最大 60 文字

名前とドメイン。企業管理ドメインの場合、ドメイン名のみが使用されます。ユーザー名でアカウント名が決定されます。その他のアカウントの種類については、ユーザーとアカウント名に使用される電子メールアドレスです。
ProductConfigurations 製品構成のニックネームのカンマ区切りリスト ユーザーを割り当てる製品構成のニックネーム。ユーザーを一度に複数の製品構成に割り当てることができます。構成名はカンマで区切ります。例えば、「Audience Management:Audience Manager - Default Access, Custom plan only - Custom plan - Design」
ユーザー名 文字列。ASCII に制限されます。 企業管理ドメインでのみ使用されます。このユーザーに使用するアカウント名。電子メールアドレスへの制約および同じ電子メールアドレスは、ドメイン所有者によって発行されます。最大長 255
CountryCode ISO 3166-1 alpha-2 国コード。これは 2 文字の国コードです(たとえば、アメリカの場合、「US」になります)。 国コードがあれば、アドビが合法的に事業を展開できる国のユーザーであることを確認します。企業管理アカウントの場合は必須です。
FirstName 文字列 最大長 255
LastName 文字列 最大長 255
オプション

コンマで区切られた名前の一覧。このフィールドは将来的に利用されます。

将来、利用が予想される値:

NoEmail: アカウントの歓迎メールの送信を控えます。

ResetPassword:パスワードをリセットするアカウントにフラグを設定します。

ダウンロード

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

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

「無効な構成名」エラー

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

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

CSV 形式の検証

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

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

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

インポートエラー

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

タイプ 電子メール ProductConfigurations ユーザー名 Country Code FirstName LastName オプション
Adobe ID 必須 任意 任意 任意 任意 任意 任意
Enterprise ID 必須 必須 任意 任意 任意 任意 任意
Federated ID 必須 必須 必須 必須 任意 任意 任意

既知の問題

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

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

 

状況

メッセージ

注意

CSV ファイルの見出し行が無効

 

CSV ファイルの見出し行が無効です。見出し行は次のいずれかになります。

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

 

アップロード時にインポートが拒否されます。一括インポートは実行されません。

CSV ファイルの見出し行がない

 

CSV ファイルの見出し行が無効です。見出し行は次のいずれかになります。

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

 

アップロード時にインポートが拒否されます。一括インポートは実行されません。

見出し行の列数が不適当 行 2 のファイル形式が無効です。詳しくは、サンプルを参考にしてください。CSV ファイル行の列数が間違っている アップロード時にインポートが拒否されます。一括インポートは実行されません。
データ行の列数が不適当

行 2 のファイル形式が無効です。詳しくは、サンプルを参考にしてください。CSV ファイル行の列数が間違っている

アップロード時にインポートが拒否されます。一括インポートは実行されません。
CSV にデータ行がないか、データ行が 1 つあり、見出し行がない ファイルは無効です。1 つ以上のユーザーをファイルに追加し、もう一度お試しください。詳しくは、サンプルを参考にしてください。 アップロード時にインポートが拒否されます。一括インポートは実行されません。
Type 値が無効

行 2 のファイル形式が無効です。ID の種類は Adobe ID、Enterprise ID、Federated ID のいずれかになります。 (ライン番号 2。)

アップロード時にインポートが拒否されます。一括インポートは実行されません。
電子メールアドレスが無効

行 2 のファイル形式が無効です。有効な電子メールアドレスが必要です。(ライン番号 2。)

アップロード時にインポートが拒否されます。一括インポートは実行されません。
電子メールアドレスが別のドメインに属する 以下参照  
国コードが 2 文字ではなく、無効 2 行目のファイル形式が無効です。国コードは ISO 3166-1 alpha-2 (2 文字の国コード)に準拠する必要があります。(ライン番号 2。) アップロード時にインポートが拒否されます。一括インポートは実行されません。合法的であり、アドビが事業を展開する国である必要があります。
国コードが禁止(例、KP) 国コードが無効です。 レポートとまとめにメッセージとして表示されます。
国コードは 2 文字であるが、無効なコードです(例、AB)。 国コードが無効です。 レポートとまとめにメッセージとして表示されます。
Firstname、Lastname、または user name、Options が長すぎる(255 を超えている) 行 3 のファイル形式が無効です。文字列が 255 文字を超えています。(ライン番号 3。) アップロード時にインポートが拒否されます。一括インポートは実行されません。
ユーザー名が電子メールアドレスではない ユーザー名が無効です。

これは認証ソースがこの一致を要求するかどうかによります。

まとめにも表示されます。

ユーザー名と電子メールアドレスは一致する必要あり ユーザー名が無効です。この組織の場合、ユーザー名と電子メールアドレスが同じになる必要あり

これは認証ソースがこの一致を要求するかどうかによります。

ユーザー名が無効です。まとめに表示されます。

電子メールアドレスのドメインが不適当 電子メールのドメインが所有されていません。このユーザーは別の組織により管理されているか、種類が異なります。 電子メールのドメインが所有されていません。まとめに表示されます。
Options フィールドの値が不正   今のところ、確認やメッセージなし
内部エラー 内部エラー: <文字列>  
ユーザーは招待済み Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。 最初の部分がまとめに表示されます。
ユーザーはすでに組織に存在 組織にすでに関連付けられています。ユーザー xxx> は所属組織にすでに関連付けられています。 最初の部分がまとめに表示されます。
サポートされないエンコーディング   サポートされない種類のエンコーディングです。

一部の特殊な事例:

組織のドメインと種類

前提条件

アクション

例外

メッセージ

d3 は Type3 要求です ユーザー u@d3 が存在、Type3 u@d3 を Type1 として追加 エラー 組織にすでに関連付けられています。 このユーザーは存在しています
  どれでも u@d3 を Type2 として追加 エラー 電子メールのドメインが所有されていません。このユーザーは別の組織により管理されているか、種類が異なります。
  ユーザー u@d3 が存在、Type3 u@d3 を Type3 として追加 エラー 組織にすでに関連付けられています。ユーザー u@d3 は所属組織にすでに関連付けられています。
  ユーザー u@d3 は組織に存在、Type1 u@d3 を Type1 として追加 エラー 組織にすでに関連付けられています。ユーザー u@d3 は所属組織にすでに関連付けられています。
  ユーザー u@d3 は組織に存在、Type1 u@d3 を Type3 として追加 エラー 組織にすでに関連付けられています。ユーザー u@d3 は所属組織にすでに関連付けられています。
 

ユーザー u@d3 は招待済み、Type1

u@d3 は存在しません

u@d3 を Type1 として追加 エラー Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。
 

ユーザー u@d3 は招待済み、Type1

u@d3 は存在しません

u@d3 を Type3 として追加 エラー Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。
 

ユーザー u@d3 は招待済み、Type1

u@d3 は招待後に作成済み、Type1

u@d3 を Type1 として追加 エラー Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。
 

ユーザー u@d3 は招待済み、Type1

u@d3 は招待後に作成済み、Type1

u@d3 を Type3 として追加 エラー

Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。

 

 

ユーザー u@d3 は招待済み、Type1

u@d3 は招待前に作成済み、Type1

u@d3 を Type1 として追加 エラー Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。
 

ユーザー u@d3 は招待済み、Type1

u@d3 は招待前に作成済み、Type1

u@d3 を Type3 として追加 エラー Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。
  ユーザー u@d3 は存在、Type1、組織ではない u@d3 を Type3 として追加 成功  
  この組織は d2 を要求していません

u@d2 を Type3 として追加

エラー 電子メールのドメインが所有されていません。このユーザーは別の組織により管理されているか、ユーザーの種類が異なります。
         
d2 は Type2 要求です ユーザー x@y は招待済み Type2 ~ d2 x@y を Type1 として追加 エラー Adobe ID ユーザーとしてすでに招待されています。招待はすでに送信されています。
  どれでも u@d3 を Type2 として追加 エラー 電子メールのドメインが所有されていません。このユーザーは別の組織により管理されているか、種類が異なります。
  どれでも x@y を Type3 として追加 エラー 電子メールのドメインが所有されていません。このユーザーは別の組織により管理されているか、種類が異なります。
         

パフォーマンス詳細

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

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

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

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

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー