組織構造と製品割り当てのエクスポートまたはインポート
適用先： Enterprise
Global Admin Consoleの書き出し機能と読み込み機能を使用して、グローバル管理者が組織管理と製品管理を効率化する方法について説明します。
Global Admin Consoleの「組織」タブにアクセスして、組織構造を書き出すか、読み込みます。 割り当てデータを表示するには、製品割り当て タブに移動します。 詳細オプション （⋮） アイコンを選択し、書き出しまたは 読み込み を選択します。 Global Admin Consoleにログインするには、こちらに移動します。
組織構造の書き出し
グローバル管理者として、組織階層を書き出すことができます。 組織階層全体またはそのサブセットのJSON、CSV、またはXLSX表現をダウンロードできます。 このデータは、分析や修正に使用できます。
選択した書き出し形式は、書き出したデータの構造に影響します。
- CSV形式：一度に1種類のデータのみを書き出すことができます。 製品プロファイルをCSV形式で書き出すと、プロファイルとリソースが1つのテーブルにまとめられます。 製品プロファイルには、リソースごとに1つずつ、複数のエントリがあります。
- XLSX形式：各組織の詳細が別のシートに表示されます。 レコードは、参照IDによって異なるオブジェクトタイプ間で接続されます。 場合によっては、特定のオブジェクトに複数の行が存在することがあります（例えば、特定のリソースに関連付けられた一連の値がある場合のリソースオブジェクト）。
- JSON形式：最も柔軟な形式 書き出されたオブジェクト間の構造的関係を利用することができます（例えば、組織内の製品は組織要素に直接表示されます）。 同じフィールドが3つの形式すべてで書き出されますが、JSON形式では一部の値が冗長です。
書き出す手順
-
Global Admin Consoleにログインします。 「組織」タブで、組織ピッカーを使用して、書き出す組織階層を選択します。 階層内のすべての組織のデータが書き出されます。
-
詳細オプション ⋮ アイコンを選択し、書き出しを選択します。
-
書き出し ダイアログボックスで、書き出す内容とデータの書き出し形式を選択します。
-
「書き出し」を選択します。 エクスポートファイルの生成には数分かかる場合があります。 レポートをダウンロードするには、Global Admin Console > インサイト > レポートの書き出しに移動します。
ファイルをダウンロードした後、データを操作してから読み込むことができます。 読み込まれた更新は、手動でデータを編集したかのように、Global Admin Consoleに表示されます。
組織構造のインポート
グローバル管理者として、変更された可能性のあるデータをインポートできます。 アップロードすると、新しいデータが現在のデータと比較され、変更が組織階層に適用されます。 すべての読み込み操作は、更新された組織階層のコピーに対して実行されます。 保留中の変更がある場合、読み込まれた変更は、階層内の既存の保留中の変更の上に追加されます。
読み込む手順
- Global Admin Consoleにログインします。 「組織」タブで、組織ピッカーを使用して、読み込みを実行する組織階層を選択します。
- 詳細オプション ⋮ アイコンを選択し、読み込みを選択します。 インポートファイルのサイズと複雑さによっては、処理に数秒から数分かかる場合があります。
- ファイルを選択し、アップロードするJSON、CSV、またはXLSX ファイルを選択します。 CSVの場合、一度に1つの組織の詳細のみを読み込むことができ、製品の読み込みはサポートされていません。 読み込まれた変更は、データを手動で編集したかのように表示されます。
- 閉じるを選択します。
- 「保留中の変更を確認」を選択します。 次に、変更を送信から実行を選択します。 変更を実行する前に、保留中のアクションは、Global Admin Consoleで手動で編集する場合と同じ方法で表示されます。
スキーマの書き出しと読み込み
CSV ファイルを使用してデータを読み込む際、フィールドは任意の順序で表示できますが、常にヘッダー行と一致する必要があります。
データの読み込み中に、各要素に対する操作を指定する必要があります。 操作は次のいずれかになります。
- 更新：編集を示します。
- 作成：新しいオブジェクト（組織、ユーザーグループ、管理者など）の作成を示します。
- 削除：オブジェクト（組織、ユーザーグループ、管理者など）の削除を示します。
操作フィールドがない入力レコードまたは空白の操作フィールドを持つ入力レコードは無視されます。
組織
読み込み要件：
- 更新または削除の場合、orgIdは階層内の既存の組織を参照する必要があります。
- 新しい組織を作成する場合は、「組織ID」フィールドを空白のままにするか、作成できる一意のID （new-1やnew-2など）に設定します。 これにより、作成する組織を参照するために使用できるIDが提供されます。
- 国コードは有効である必要があります。
- 更新および 削除 操作の組織Idは、既に組織階層に存在している必要があります。
- Deleteとマークされた組織IDは、Updateまたは Create 操作を行う組織のparentOrgIdとして選択しないでください。
- 同じレベルで同じ親の子組織に同じorgNameを指定することはできません。
- 組織を作成したり、組織名を更新したりする場合、組織の名前は同じ親の既存の子の名前と一致してはなりません。
管理者
読み込み要件：
- orgId、email、adminTypeおよびuserTypeには、有効な値を含める必要があります。
- countryCodeは有効である必要があります。
- ユーザーが既に存在し、更新されている場合、userTypeはユーザーと一致する必要があります。
- 組織内でメールアドレスが重複していないか確認します。
製品プロファイル
製品プロファイルの書き出しと読み込みは、製品プロファイルの詳細と、製品プロファイルに関連付けられた一連のリソースの2つの部分で構成されます。 これらのリソースは、通常、それらを有効または無効にするために、設定できるサービスを特定します。
- リソースオブジェクトは、JSON形式で製品プロファイル内にネストされます。
- 製品プロファイルでCSVまたはXLSXを使用する場合、プロファイルとリソースは1つのテーブルに結合されます。 製品プロファイルには、リソースごとに1つずつ、複数のエントリがあります。
- リソースで選択したフィールドは、サービスを有効にするかどうかを制御します。
- 製品プロファイルを読み込む場合、製品プロファイル自体と、更新または作成するリソースオブジェクトに対して「作成」または「更新」操作が必要です。
読み込み要件：
-
productProfileId、licenseId、およびorgIdには有効な値が必要です。
-
製品プロファイルを作成する場合、productProfileNameは有効な名前である必要があり、同じ組織内の別の製品プロファイル名またはユーザーグループ名を複製することはできません。
-
クォータ フィールドには、単位タイプに対して有効な値が必要です。 resourceType=QUOTAの場合は数値、それ以外の場合は空白になります。
-
通知フィールドはtrueまたはfalseである必要があります。
-
CSVおよびXLSXのインポートの場合は、productProfileIdを検証します。すべてのエントリには、同じorgId、licenseId、およびproductProfileNameが必要です。
-
入力ファイルと組織でproductProfileNameが重複していることを検証します。
-
更新および削除するプロファイルは、組織内に存在する必要があります。
-
更新および削除（非アクティブ化）するリソースは、プロファイルに存在する必要があります。
-
プロファイルを作成するには、次の点を確認します。
- 組織IDは、新しい組織または既存の組織である必要があります。
- licenseIdは、新製品または既存製品である必要があります。
- プロファイルのリソースを検証します。
製品プロファイルのリソース
読み込み要件：
- リソースの操作フィールドは、そのリソースが属する製品プロファイルに 削除 または 作成 という操作が設定されている場合は無視されます。
- 削除するリソースをマークする必要はありません。無効な操作です。
- 製品プロファイルを作成するには、リソースの数がソース製品プロファイルのリソース数と一致している必要があります。
- 更新操作を持つリソースの場合、製品プロファイルにリソースが存在する必要があります。
ユーザーグループ
読み込み要件：
-
orgIdは、既存の組織または同じインポートで作成される組織を参照する必要があります。
-
userGroupIdは、更新または削除のために既存のグループを参照する必要があり、新しいユーザーグループ用に定義するIDにすることができます。
-
更新または作成の場合、userGroupNameは空白にせず、同じ組織内の別のユーザーグループまたは製品プロファイル名を複製しないでください。
-
入力ファイルと組織でuserGroupNameが重複していないことを確認します。
-
更新および削除するユーザーグループは、組織内に存在する必要があります。
-
ユーザーグループから削除するプロファイルは、ユーザーグループに存在する必要があります。 ユーザーグループのプロファイルに対して更新操作を実行することはできません。
-
ユーザーグループを作成するには、次の点を確認します。
- 組織IDは、新しい組織または既存の組織である必要があります。
- licenseId （該当する場合）は、新製品または既存の製品である必要があります。
- productProfileIdは、新しい製品プロファイルまたは既存の製品プロファイルである必要があります。
ドメイン
ドメイン情報は、各組織で使用可能なドメインに関する読み取り専用の情報を提供します。 このデータは編集できません。
製品とリソース products-and-resources
XLSX ファイルには、製品用とリソース用の2つのシートがあります。 JSONでは、リソースオブジェクトはproduct オブジェクトにネストされます。
製品
読み込み要件：
- 作成する場合、licenseIdは作成する一意のIDである必要があります。
- 更新する場合、licenseIdは、指定した組織内の既存の製品のIDである必要があります。
- orgIdは、既存の組織または同じ読み込み操作で作成されている組織を参照する必要があります。
- createの場合、sourceLicenseIdは、同じ読み込み操作で作成される製品に対して定義した既存の製品またはIDを参照する必要があります。
- Create操作を持つ製品では、licenseIdとsourceLicenseIdを同じにすることはできません。
- 製品の組織を検証します。組織は新しいものであるか、組織階層に既に存在する必要があります。
- 更新および 削除 操作の場合、製品は既に組織階層に存在している必要があります。
- DeleteとマークされたlicenseIdは、Createおよび Update 操作の製品のsourceLicenseIdとして使用しないでください。
- Create操作を持つ製品の場合、sourceLicenseIdが親組織に存在することを検証します。
製品のリソース
リソースオブジェクトは、製品および製品プロファイルに表示できます。
読み込み要件：
リソースが属する製品に Delete または Create という操作が設定されている場合、リソースの操作フィールドは無視されます。
- 削除するリソースをマークする必要はありません。無効な操作です。
- 製品を作成するには、リソースの数がソース製品のリソース数と一致している必要があります。
- 更新操作を持つリソースの場合、そのリソースは製品に存在する必要があります。
製品割り当てデータのインポートとエクスポート
グローバル管理者は、製品割り当てデータをJSONまたはCSV ファイルとして書き出すことができます。 その後、このデータを変更してアップロードし、変更をインポートできます。 変更の可能性のあるデータがアップロードされると、新しいデータが現在のデータと比較され、変更が製品割り当てデータに適用されます。 その後、保留中の変更を確認して送信し、有効にすることができます。
製品配分モデルのエクスポート
製品配分モデルを書き出すには、次の操作を行います。
- Global Admin Consoleにログインし、Product Allocation タブに移動します。
- 詳細オプション ⋮ アイコンを選択し、CSVの書き出しまたは JSONの書き出し を選択します。 ファイルがダウンロードされます。 書き出し形式について詳細を見る。
製品配分モデルのインポート
データを書き出し、変更したファイルを読み込むことができます。 製品配分モデルを読み込むには、次の操作を行います。
- Global Admin Consoleにログインし、Product Allocation タブに移動します。
- 詳細オプション ⋮ アイコンを選択し、読み込みを選択します。
- アップロードするJSON ファイルまたはCSV ファイルを選択します。
- 「保留中の変更を確認」を選択します。 変更を確認したら、変更を送信から実行を選択します。
製品配分用のエクスポートおよびインポート形式
書き出し形式と読み込み形式は同じです。 CSV形式で読み込む場合、フィールドは任意の順序で表示できますが、ヘッダー行と一致する必要があります。 JSON形式で読み込む場合、フィールドは任意の順序で表示されます。
製品配分データを読み込む際に、操作を指定する必要があります。 操作は次のいずれかになります。
- 更新：編集（grantedQuantity、allowOverAllocation値に変更）を示します。
- 作成：指定した組織に製品リソースを追加することを示します。
- 削除：製品の削除を示します。
操作が与えられない場合、CSVまたはその行のJSONのデータが読み込まれたときに変更は発生しません。
書き出されたファイルには、製品リソースごとに1つの行またはレコードがあります。 一部の製品には、複数のリソースがあります。
製品に複数のリソースがある場合は、更新操作を独立したリソースに適用できます。削除操作では、組織からのすべてのリソースを含む製品が削除され、作成操作では、インポートファイル内の各リソースに対するレコードが必要になります。これにより、各リソースの適切な量を指定できます。 allowOverAllocation フィールドは製品全体であり、このフィールドに対する更新がどのリソースに含まれているかは関係ありません。
ヘッダーの説明
要件の読み込み
データ検証
-
操作フィールドには有効な操作が必要です。
-
製品インポートデータには、必須フィールドのプロパティと値が必要です。
-
製品読み込みデータのプロパティは、正しいタイプである必要があります。
-
製品ポリシーフィールド（overAllocation）は、異なるリソースに対して指定しないでください。
-
grantedQuantity フィールド：
- まだ unlimited になっていない場合は、unlimitedに変更できません。
- 負でない整数または文字列値無制限である必要があります。
権限/アクセス可能な検証
- インポート データに関連付けられている組織が存在する必要があります。 更新する場合は、インポートデータに関連付けられている製品とリソースが実際に存在することを確認します。
製品検証を追加
- SourceLicenseIdが存在する必要があります。
- 新しい製品に関連付けられている組織が存在する必要があります。
- 作成する製品（同じlicenseIdを持つ製品）が存在しない必要があります。
- 作成する製品に関連付けられているリソースには、その製品と一致する対応するproductIdが必要です。