CTT 使用後の IMS へのプリンシパルの一括アップロード

最終更新日： 2025年4月1日

はじめに

CTT と CAM を使用してコンテンツをクラウドに移行すると、AEM クラウドインスタンス上にグループが作成されますが、IMS にグループやユーザーを配置できません。顧客が適切に管理するには、グループやユーザーを IMS 内に配置する必要があります。幸いにも、Admin Console には IMS グループとユーザーを一括作成する機能が用意されています。CAM の取り込みは、この一括作成用に入力ファイルを保存することで、このプロセスを支援します。これにより、お客様は、移行プロセス全体の一部として、この Admin Console のアクションを完了できます。グループ用とユーザー用の 2 種類の一括アップロードファイルが作成されます。

AEM as a Cloud Service ユーザーの管理について詳しくは、ユーザーの管理も参照してください。

ファイルのアップロードに関する一般的なルール

両方の種類のアップロードファイルを編集および使用する際の一般的なガイドラインがいくつかあります。

  • これらの手順を実行するには、まず Admin Console への管理者アクセスを許可する必要があります。

  • IMS でユーザーとグループを作成するには、いくつかの異なる方法があります。使用可能なすべてのオプションについて詳しくは、Adobe Experience Manager as a Cloud Service の IMS サポートを参照してください。ここでは、Admin Console の一括アップロード方法についてのみ説明します。

  • IMS には、Adobe ID、Enterprise ID、Federated ID の 3 つの ID タイプがあります。このページの手順は、Adobe ID のみ ​を対象としています。Enterprise ID または Federated ID を使用する必要がある場合は、Admin Console の完全なドキュメントと、Admin Console の一括グループアップロード、Admin Console の一括ユーザーアップロードに関する特定のドキュメントを参照してください。これらの 2 つの ID タイプでは、アップロードファイルの仕様が若干異なります。

  • 1 つの CSV フィールドで複数のエントリ（複数の製品プロファイル、複数のグループ、複数の管理者など）が許可されている場合、エントリを二重引用符で囲み、コンマ（"profile 1,profile 2" など）で区切る必要があります。

    • この場合、二重引用符ではなく一重引用符が使用されることがありますが、Microsoft Excel でファイルを編集すると、解析の問題が発生する可能性があります。Excel を使用してこれらのファイルを編集する場合は、一重引用符ではなく、必ず二重引用符を使用してください。

一括グループアップロード

ユースケース：グループは AEM as a Cloud Service に移行されましたが、これらのグループは IMS/Admin Console に存在しないので、Admin Console を通じて IMS にアップロードする必要があります。

CTT/CAM の移行を実行した後に Admin Console の一括グループアップロード機能を使用するには、次の手順に従います。

  1. CAM から一括グループファイルのダウンロード

    1. CAM で​ コンテンツ転送 ​に移動し、「取り込みジョブ」を選択します。
    2. 該当する取り込み行の省略記号（…）をクリックし、「プリンシパルの概要を表示」を選択します。
    3. 表示されるダイアログで、「ファイルをダウンロード…」の下のドロップダウンリストから「一括グループファイル」を選択し、「ダウンロード」ボタンをクリックします。
    4. 結果の CSV ファイルを保存します。

  2. 一括グループファイルの編集

    • 各行は、アップロードするグループを表し、次の 4 つのフィールドがあります（フィールド名はファイルの最初の行を構成します）。

      • ユーザーグループ名 - グループ名は必須で、最大 255 文字を含めることができます。このグループ名は、IMS と AEM で同じにする必要があります。

      • 説明 - このフィールドはオプションで、最大 255 文字を含めることができます。

      • ユーザーグループ管理者 - このフィールドには 1 人以上のグループ管理者を含める必要があります。各管理者をコンマで区切り、リストを引用符で囲むことで、複数の管理者を割り当てることができます。各管理者のエントリには、ユーザーの ID タイプ、ハイフン、メールアドレスを含める必要があります。例：
        "Adobe ID-myAdmin@example.com,Adobe ID-myOtherAdmin@example.com"。管理者を区切るコンマの後にスペースを含めないでください。Admin Console に現在組織に属していないユーザーを（管理者として）含めることはできません。

      • 割り当てられた製品プロファイル - このフィールドはオプションです。各プロファイルをコンマで区切り、リストを引用符で囲むことで、複数の製品プロファイルを割り当てることができます。ただし、含める製品プロファイルは、組織に対して既に設定されている必要があります。製品名ではなく、製品プロファイル名を指定します。グループに割り当てられた製品プロファイルのメンバーシップは、このグループに配置されているすべてのユーザーに継承されます。製品プロファイルを検索するには：

        1. Admin Console に移動します。
        2. 製品（Adobe Experience Manager as a Cloud Service など）を見つけて、クリックします。
        3. 環境（インスタンス）を見つけて、クリックします。
        4. 製品プロファイルを一覧表示し、AEM 環境の製品プロファイルをクリックします。製品プロファイルは上部に表示されます（「AEM ユーザー - 作成者 - プログラム 12345 - 環境 012345」）。

    • CSV を編集する際、一部のアプリケーションでは保存時に引用符が追加され、処理が失敗する場合があります。生の CSV をシンプルなテキストエディターで検査して、各フィールドに開始引用符と終了引用符が 1 つずつのみ含まれている（および「スマート引用符」ではない）ことを確認することをお勧めします。

  3. Admin Console で、一括グループファイルをアップロードします。

    1. Admin Console で、ユーザー、ユーザーグループ ​の順に移動します。

    2. 右側にある「…」ボタンをクリックします。メニューから「CSV でユーザーグループを追加」を選択し、アップロードする CSV を選択します。「アップロード」をクリックします。

    3. CSV が（Admin Console に）アップロードされたが、IMS にはまだ読み込まれていないという応答が表示されます。

    4. 同じ「…」メニューに移動し、「一括操作の結果」を選択します。一括アップロードの試行のリストが表示され、一括アップロードが処理中か、成功したか、失敗したかが（ステータス ​の下に）表示されます。

      • 最初は「処理中」と表示され、まだ完了していないことを示します。
      • 正常に完了したら、ユーザーグループを追加 ​リンクをクリックします。これにより、各行にシンプルなステータスメッセージが表示されます。
      • 代わりに失敗した場合は、ファイル ​の下にある小さなアイコンをクリックすると、失敗した理由に関する詳細情報が表示されます。グループ行番号は、行 1 から参照されます。

  4. Admin Console を使用して、変更を確認します。