Увійдіть у Global Admin Console.На вкладці Організації за допомогою засобу вибору організацій оберіть ієрархію організацій, де потрібно виконати експорт. Дані всіх організацій в ієрархії експортуються.
Останнє оновлення:
17 черв. 2025 р.
Дізнайтеся, як глобальні адміністратори можуть оптимізувати керування організацією та продуктами за допомогою функцій експортування та імпортування в консолі Global Admin Console.
Перейдіть на вкладку Організації в консолі Global Admin Console, щоб експортувати або імпортувати структуру організації, а для даних про розподіл відкрийте вкладку Розподіл продуктів. Скористайтеся значком Додаткові параметри , щоб вибрати експортування або Імпорт.
Експортування структури організації
Як глобальний адміністратор, ви можете експортувати ієрархію організації. Ви можете завантажити представлення всієї ієрархії організації або її підмножини у форматі JSON, CSV або XLSX. Потім ви можете використовувати ці дані для аналізу або внесення змін.
Вибраний формат експортування впливає на структуру експортованих даних.
- Формат CSV дозволяє експортувати лише один тип даних за раз. При експортуванні профілів продуктів у форматі CSV профілі та ресурси об'єднуються в одну таблицю. Існують кілька записів для профілю продукту, по одному для кожного ресурсу.
- Формат XLSX призводить до відображення кожної деталі організації в окремому аркуші.
Записи пов'язані між різними типами об'єктів за допомогою ідентифікатора посилання. У деяких випадках може бути кілька рядків для конкретного об'єкта, наприклад, у випадку об'єктів ресурсів, коли є набір значень, пов'язаних з певним ресурсом.
- Формат JSON є найбільш гнучким. Він може використовувати структурні зв'язки між експортованими об'єктами. Наприклад, продукти в організації з'являються безпосередньо в елементі організації.Одні й ті самі поля експортуються у всіх трьох форматах, але деякі значення є надлишковими у форматі JSON.
Виберіть піктограму Додаткові параметри і виберіть Експорт.
У діалоговому вікні Експорт оберіть, що потрібно експортувати, і формат для експорту даних.
Натисніть Експорт. Створення файлу експорту може зайняти кілька хвилин. Після завершення, щоб завантажити звіт, перейдіть до Global Admin Console > Insights > Експорт звітів. Докладніше про функцію «Звіти експорту».
Примітка
Файли JSON експортуються у форматі zip. Їх можна відкрити за допомогою утиліти zip або функцій zip операційної системи.
Після завантаження файлу можна маніпулювати даними, а потім імпортувати їх назад. Імпортовані оновлення відображаються в Global Admin Console так, ніби ви відредагували дані вручну.
Імпортувати структуру організації
Як глобальний адміністратор, ви можете імпортувати потенційно змінені дані. Після передавання нові дані порівнюються з поточними даними, і всі зміни застосовуються до ієрархії організацій. Всі операції імпорту виконуються з оновленою копією ієрархії організацій. Якщо є відкладені зміни, зміни імпорту додаються поверх відкладених змін в ієрархії.
Увійдіть до Global Admin Console.На вкладці Organizations скористайтеся засобом вибору організації, щоб вибрати ієрархію організації, де потрібно виконати імпорт.
Виберіть піктограму More Options 
і виберіть Import. Залежно від розміру та складності файлу для імпорту, обробка може тривати від кількох секунд до кількох хвилин.
Виберіть Select a file і оберіть файл JSON, CSV або XLSX для передавання.Для CSV можна одночасно імпортувати лише дані однієї організації, і цей формат не підтримує імпорт продуктів.
Імпортовані зміни відображаються так, ніби ви відредагували дані вручну.
Виберіть Закрити.
Виберіть Review Pending Changes. Потім виберіть Submit Changes, щоб виконати їх.
Перед виконанням змін очікувані дії відображаються так само, як під час ручного редагування в консолі Global Admin Console.
Схеми експорту та імпорту
Під час імпорту даних за допомогою файлу CSV поля можуть розташовуватися в будь-якому порядку, але мають завжди відповідати рядку заголовка.
Під час імпорту даних потрібно вказати операцію для кожного елемента. Операція може бути будь-якою з наведених нижче операцій:
- Update: означає редагування.
- Create: означає створення нового об'єкта (наприклад, організації, групи користувачів або адміністратора).
- Delete: означає видалення об'єкта (наприклад, організації, групи користувачів або адміністратора).
Вхідні записи без поля операції або з порожнім полем операції ігноруються.
| Назва поля | Опис | Примітки |
|---|---|---|
| ідентифікатор | Ідентифікатор організації. Під час додавання нової організації це поле може бути порожнім або містити ідентифікатор заповнювача, наприклад, new_org_1. Ідентифікатор заповнювача використовується в тих випадках, коли інші імпортовані записи мають посилатися на цю організацію. Після створення буде призначено фактичний ідентифікатор організації, який замінить усі використання ідентифікатора заповнювача організації. |
Можна встановити тимчасове значення під час operation=create |
| назва | Проста назва організації. Мінімальна довжина 4, максимальна 100. Назви можуть містити символи UTF-8 до 3 байтів, 4-байтові символи не підтримуються. |
Можна встановити або оновити під час operation=create або operation=update відповідно |
| countryCode | Код країни або регіону | Має бути встановлено під час operation=create, можна оновити під час operation=Update |
| тип | Тип організації | Тільки для читання |
| parentOrgId | Ідентифікатор батьківської організації.Порожньо для кореневої організації. Під час оновлення діють значні обмеження, включаючи те, що новий батьківський елемент має бути в тій самій ієрархії та мати продукти, які присутні в організації. |
Можна встановити або оновити під час operation=create або operation=update відповідно |
| adminCount | Кількість адміністраторів | Тільки для читання |
| domainCount | Кількість доменів | Тільки для читання |
| userCount | Кількість користувачів | Тільки для читання |
| userGroupCount | Кількість груп користувачів | Тільки для читання |
| адміністратори | Набір об'єктів адміністратора, що представляють адміністраторів цієї організації |
Може бути відсутнім, якщо не вибрано для експорту. Відображається в окремій вкладці у файлах XLSX. |
| domains | Набір об'єктів доменів, що представляють домени в цій організації |
|
| продукти | Набір об'єктів продуктів, що представляють продукти в цій організації |
|
| productProfiles | Набір об'єктів профілів продуктів, що представляють профілі продуктів у цій організації |
|
| userGroups | Набір об'єктів груп користувачів, що представляють групи користувачів у цій організації |
|
| orgPolicies | Структура, що представляє політики та їх значення | |
| operation | Одне з: порожнє, cтворити, оновити або DELETE. Дія, яку потрібно виконати під час імпорту даних. | Завжди порожнє під час експорту. |
Вимоги до імпорту:
- Для оновлення або видалення orgId повинен посилатися на існуючу організацію у вашій ієрархії.
- Якщо ви створюєте нову організацію, поле orgId можна залишити порожнім або встановити унікальний ідентифікатор, який можна придумати, наприклад new-1 або new-2. Це надає ідентифікатор, який можна використовувати для посилання на організацію, яку потрібно створити.
- Код країни має бути дійсним.
- orgId для операцій оновлення та видалення має вже існувати в ієрархії організації.
- orgId, позначений як Delete , не слід вибирати як parentOrgId для організацій з операціями Update або Create .
- Дочірні організації на одному рівні з одним і тим же батьківським елементом не можуть мати однакові назви orgName.
- Під час створення організації або оновлення назви організації, назва організації не повинна збігатися з назвою існуючої дочірньої організації того самого батьківського елемента.
| Назва поля | Опис | Використання |
|---|---|---|
| orgId | Посилання на організацію, в якій працює адміністратор. | Використовується як посилання для пошуку об'єктів, що містяться або пов'язані. |
| firstName | Ім'я користувача-адміністратора. Ім'я та прізвище для користувачів Adobe ID можна замінити значенням, заданим користувачем, коли користувач прийме запрошення. |
Можна встановити або оновити, коли operation=create або operation=update відповідно |
| lastName | Прізвище користувача-адміністратора | |
| електронну | Електронна пошта користувача-адміністратора. Це основний ключ для користувача і повинен бути унікальним. | |
| countryCode | Код країни або регіону, де працює користувач. Застосовується лише до типів Federated та Enterprise ID. |
|
| userType | Один з варіантів: «Adobe ID», «Enterprise ID» або «Federated ID». | Тільки для читання |
| adminType | Один з варіантів: «GLOBAL ADMIN», «GLOBAL VIEWER», «SYSTEM ADMIN», «USER GROUP ADMIN», «PRODUCT ADMIN», «PRODUCT PROFILE ADMIN», «DEPLOYMENT ADMIN» та «STORAGE_ADMIN». | Можна встановити, коли operation=Create |
| groupId | Ідентифікатор групи, адміністратором якої є цей користувач. Стосується лише адміністраторів груп користувачів і профілів продуктів. | |
| licenseId | Ідентифікатор ліцензії продукту, адміністратором якого є цей користувач. Стосується лише адміністраторів продуктів. | |
| домену | Доменне ім'я користувача, якщо не використовується домен електронної пошти | |
| userName | Ім'я користувача, якщо не використовується адреса електронної пошти | |
| operation | Одне з наступного: порожнє, Create, Update або DELETE. Дія, яку потрібно виконати під час імпорту даних. |
Вимоги до імпорту:
- orgId, електронна пошта, adminType та userType повинні містити дійсні значення.
- countryCode повинен бути дійсним.
- Якщо користувач уже існує й оновлюється, userType повинен відповідати користувачу.
- Перевірте наявність дублікатів адрес електронної пошти в організації.
Експорт і імпорт профілів продуктів складається з двох частин: деталей профілю продукту та набору ресурсів, пов'язаних із профілем продукту. Ці ресурси ідентифікують служби, які можна налаштовувати, зазвичай лише для їх увімкнення або вимкнення.
- Об'єкти ресурсів вкладено в профіль продукту у форматі JSON.
- Під час використання CSV або XLSX із профілями продуктів профілі та ресурси об'єднуються в одну таблицю. Для профілю продукту буде кілька записів — по одному для кожного ресурсу.
- Поле «selected» у ресурсі контролює, чи ввімкнено службу.
- Під час імпорту профілів продуктів повинна бути операція Create або Update для самого профілю продукту та для будь-яких об'єктів ресурсів, які потрібно оновити або створити.
| Назва поля | Опис | Використання |
|---|---|---|
| productProfileId | Ідентифікатор профілю продукту Значення заповнювача можна використовувати під час створення, щоб інші об'єкти могли посилатися на новий профіль. |
Можна встановити тимчасове значення, коли operation=create |
| productProfileName | Назва профілю продукту. Не може дублювати інші профілі продуктів або групи користувачів в тій самій організації. |
Можна встановити або оновити, коли operation=create або operation=update відповідно |
| productProfileDescription | Текстовий опис профілю продукту | |
| licenseId | Посилання на ідентифікатор ліцензії продукту | Використовується як посилання для пошуку пов'язаного об'єкта |
| orgId | Організація, що містить групу користувачів | |
| сповіщення | True або false, щоб вказати, чи потрібно надсилати сповіщення електронною поштою користувачам, коли їх додають або видаляють з цього профілю продукту | Можна встановити або оновити, коли operation=create або operation=update відповідно |
| resources | Масив ресурсів, пов'язаних з цим профілем продукту. Поле resources присутнє лише для формату JSON. Для форматів CSV та XLSX ресурси відображаються наступними додатковими полями: resourceName, resourceId, resourceDescription, icon, selected, quota, resourceType. Детальну інформацію про ці поля див. у розділі Продукти та ресурси. Якщо профіль продукту має більше одного ресурсу, буде кілька рядків, по одному для кожного ресурсу. Інші поля матимуть однакові значення для кожного ресурсу. |
|
| operation | Одне з наступних: порожнє значення, Create, Update або Delete.Дія, яку потрібно виконати під час імпорту даних. |
Вимоги до імпорту:
- productProfileId, licenseId та orgId повинні мати дійсні значення.
- Під час створення профілю продукту productProfileName має бути дійсною назвою та не повинна дублювати назву іншого профілю продукту або групи користувачів в тій самій організації.
- Поле «Квота» повинно мати дійсне значення для типу одиниці.Це числове значення або "unlimited", коли resourceType=QUOTA, або порожнє в іншому випадку.
- Поле сповіщення має мати значення true або false.
- Для імпорту CSV та XLSX перевірте productProfileId — усі його записи повинні мати однакові orgId, licenseId та productProfileName.
- Перевірте дублікати productProfileName у вхідному файлі та організації.
- Профілі, які потрібно оновити та видалити, повинні бути присутні в організації.
- Ресурси, які потрібно оновити та видалити (деактивувати), повинні бути присутні в профілі.
- Для створення профілів переконайтеся в наступному:
- OrgId має бути новою організацією або існуючою організацією.
- LicenseId має бути новим продуктом або існуючим продуктом.
- Перевірте ресурси для профілю.
Ресурси в профілях продуктів:
| Назва поля | Опис | Використання |
|---|---|---|
| resourceName | Назва ресурсу | Тільки для читання |
| resourceId | Ідентифікатор ресурсу | Тільки для читання |
| resourceDescription | Текстовий опис ресурсу | Тільки для читання |
| значок | URL до зображення для ресурсу | Тільки для читання |
| вибрано | Для запису конфігурації вказує, чи увімкнено функцію. Це поле присутнє лише в JSON. |
Можна встановити або оновити, коли operation=create або operation=update відповідно |
| квота | Кількість основного ресурсу, яку можна надати користувачам через цей профіль продукту. Це поле присутнє лише в JSON. |
|
| resourceType | Якщо задано, значення — SERVICE.Це вказує, що цей ресурс представляє службу, яку можна увімкнути або вимкнути залежно від значення вибраного поля. Це поле присутнє лише в JSON. |
Тільки для читання |
| операція | Одне з наступних: порожнє, Create, Update або Delete. Дія, яку потрібно виконати під час імпорту даних. |
Вимоги до імпорту:
Поле операції для ресурсів ігнорується, коли профіль продукту, до якого вони належать, має операції зі значеннями Delete або Create.
- Жоден ресурс не повинен бути позначений для видалення, це недійсна операція.
- Для створення профілів продуктів кількість ресурсів повинна відповідати кількості ресурсів вихідного профілю продукту.
- Для ресурсів з операцією Update ресурс повинен бути присутній у профілі продукту.
| Назва поля | Опис | Використання |
|---|---|---|
| userGroupId | Ідентифікатор групи користувачів Під час створення можна використовувати значення-заповнювач, щоб інші об'єкти могли посилатися на нову групу користувачів. |
Можна встановити тимчасове значення, коли operation=create |
| userGroupName | Назва групи користувачів | Можна встановити або оновити при operation=create або operation=update відповідно |
| userGroupDescription | Текстовий опис групи користувачів | |
| userCount | Кількість користувачів у групі користувачів | Тільки для читання |
| профілі | Масив ідентифікаторів профілів продуктів, з якими пов'язана група користувачів. XLSX має один рядок на кожне значення з однаковими значеннями для інших полів. |
Можна встановити або оновити при operation=create або operation=update відповідно |
| orgId | Організація, яка містить групу користувачів | Використовується як посилання для пошуку об'єкта-контейнера або пов'язаного об'єкта. |
| operation | Одне з порожніх значень: Create, Update або Delete. Дія, яку потрібно виконати під час імпорту даних. |
Вимоги до імпорту:
- orgId має посилатися на наявну організацію або організацію, яка створюється в тому ж імпорті.
- userGroupId має посилатися на наявну групу для оновлення або видалення і може бути ідентифікатором, який ви визначаєте для нових груп користувачів.
- Для оновлення або створення userGroupNameorganization не повинно бути порожнім і не повинно дублювати назву іншої групи користувачів або профілю продукту в тій же організації.
- Переконайтеся, що userGroupName не дублюється у вхідному файлі та організації.
- Групи користувачів, які потрібно оновити або видалити, мають бути присутні в організації.
- Профіль, який потрібно видалити з групи користувачів, має бути присутній у групі користувачів. Операції оновлення не можна виконувати для профілю групи користувачів.
- Для груп користувачів, які потрібно створити, переконайтеся в наступному:
- OrgId має бути новою організацією або існуючою організацією.
- LicenseId, якщо застосовно, має бути новим продуктом або існуючим продуктом.
- ProductProfileId має бути новим профілем продукту або існуючим профілем продукту.
Інформація про домен надає інформацію «Тільки для читання» про домени, доступні в кожній організації. Ці дані не редагуються.
|
Назва поля |
Опис |
Використання |
|---|---|---|
|
orgId |
Посилання на організацію, в якій перелічений цей домен |
Використовується як посилання для пошуку вмісних або пов'язаних об'єктів. |
|
domainName |
Назва домену, наприклад, adobe.com. |
Тільки для читання |
|
directoryName |
Назва каталогу, в якому перелічений домен |
Тільки для читання |
|
directoryType |
Один із Federated ID або Enterprise ID. |
Тільки для читання |
|
domainStatus |
Один із «ACTIVE», «RESERVED», «UNCLAIMED», «CLAIMED», «VALIDATED», «WITHDRAWN», «ACTIVE», «EXPIRED». |
Тільки для читання |
У файлах XLSX є два аркуші — один для продуктів та один для ресурсів. У JSON об'єкти ресурсів вкладені в об'єкт продукту.
Продукти:
| Назва поля | Опис | Використання |
|---|---|---|
| licenseId | ідентифікатор, який ідентифікує продукт. Кожен продукт має унікальний ідентифікатор ліцензії в організації, в якій він зазначений. Ідентифікатор ліцензії для одного й того ж продукту відрізнятиметься в різних організаціях. Під час додавання нового продукту це поле може бути порожнім або містити ідентифікатор-заповнювач, наприклад, new_product_1. Ідентифікатор-заповнювач використовується у випадках, коли інші імпортовані записи повинні посилатися на цей екземпляр продукту. Після створення призначається фактичний ідентифікатор ліцензії, який замінює всі використання ідентифікатора ліцензії-заповнювача. |
Можна встановити тимчасове значення, коли operation=create |
| productName | Назва продукту | Тільки для читання |
| productDescription | Текстовий опис продукту | Тільки для читання |
| allowOverallocation | Логічне значення, яке вказує, чи дозволено надмірне розподілення цього екземпляра продукту. Надмірне розподілення означає можливість надати дочірній організації більшу кількість, ніж вам було надано. |
Можна встановити або оновити, коли operation=create або operation=update відповідно |
| значок | URL значка продукту | Тільки для читання |
| sourceLicenseId | Ідентифікатор ліцензії екземпляра продукту в організації, з якої було розподілено цей продукт. Значення дорівнює null, якщо цей екземпляр не є розподіленим продуктом, а натомість є придбаним продуктом. | Можна встановити, коли operation=Create |
| productId | Ідентифікатор продукту. | Тільки для читання |
| orgId | Ідентифікатор організації, що містить цей екземпляр продукту | Використовується як посилання для пошуку об'єкта-контейнера або пов'язаного об'єкта. |
| redistributable | Логічне значення, що вказує, чи має цей продукт ресурси, які можна надати дочірнім організаціям. | Тільки для читання |
| resources | об'єкт, що містить набір об'єктів ресурсів, які представляють ресурси та Параметри в цьому продукті | |
| операція | Одне з наступних значень: пусте, створити, оновити або видалити.Дія, яку потрібно виконати під час імпорту даних. |
Вимоги до імпорту:
- Для створення licenseId має бути унікальним ідентифікатором, який ви створюєте.
- Для оновлення licenseId має бути ідентифікатором наявного продукту в зазначеній організації.
- orgId має посилатися на наявну організацію або на ту, що створюється в тій самій операції імпорту.
- Для створення sourceLicenseId має посилатися на наявний продукт або ідентифікатор, який ви визначили для продукту, що створюється в тій самій операції імпорту.
- licenseId і sourceLicenseId не повинні бути однаковими для продуктів з операцією cтворити .
- Перевіряйте організації продуктів — організація має бути новою або вже присутньою в ієрархії організацій.
- Для операцій оновити та видалити продукт уже має бути присутнім в ієрархії організацій.
- licenseId, позначений як DELETE , не повинен використовуватися як sourceLicenseId продуктів з операціями cтворити та оновити .
- Для продуктів з операцією cтворити перевіряється, щоб sourceLicenseId був присутнім в Шаблон організації.
Ресурси для продуктів:
Об'єкти ресурсів можуть з'являтися в продуктах і в профілях продуктів.
| Назва поля | Опис | Використання |
|---|---|---|
| resourceName | Назва ресурсу | Тільки для читання |
| resourceId | Ідентифікатор ресурсу | Тільки для читання |
| resourceDescription | Текстовий опис ресурсу | Тільки для читання |
| значок | URL зображення для ресурсу | Тільки для читання |
| productName | Назва продукту, частиною якого є цей ресурс. | Тільки для читання |
| licenseId | Ідентифікатор ліцензії (екземпляр продукту) продукту, частиною якого є цей ресурс. | Використовується як посилання для пошуку контейнера або пов'язаного об'єкта. |
| grantedQuantity | Надана кількість цього ресурсу: обсяг ресурсів, якими ця організація може скористатися локально або розподілити між дочірніми організаціями. | Можна встановити або оновити, якщо operation=create або operation=update відповідно |
| unit | Назва одиниці вимірювання наданої кількості. | Тільки для читання |
| currentQuantity | Поточна доступна кількість в цій організації. Це надана кількість мінус ресурси, розподілені між дочірніми організаціями. Це значення відображається в консолі Admin Console для цього продукту/ресурсу. | Тільки для читання |
| provisionedQuantity | Фактично надана кількість: може бути меншою за дозвіл або поточну кількість, може бути меншою за currentQuantity, якщо діє певне обмеження. | Тільки для читання |
| операція | Одне з: порожнє, Створити, Оновити або Видалити.Дія, яку слід виконати під час імпорту даних. |
Вимоги до імпорту:
Поле операції для ресурсів ігнорується, якщо для продукту, до якого вони належать, встановлено операції Видалити або Створити.
- Жоден ресурс не повинен бути позначений для видалення — це недійсна операція.
- Для продуктів, які потрібно створити, кількість ресурсів повинна відповідати кількості ресурсів вихідних продуктів.
- Для ресурсів з операцією Оновити ресурс має бути присутнім у продукті.
Імпорт та експорт даних розподілу продуктів
Як Global Administrator, ви можете експортувати дані розподілу продуктів у форматі JSON або CSV.Потім ви можете обробити ці дані та передати їх назад для імпорту змін.Коли потенційно змінені дані передаються, нові дані порівнюються з поточними даними і будь-які зміни застосовуються до даних розподілу продуктів.Потім ви можете переглянути та подати відкладені зміни, щоб вони набули чинності.
Експортувати модель розподілу продуктів
Щоб експортувати модель розподілу продуктів, виконайте наступні дії:
- Увійдіть до Global Admin Console та перейдіть на вкладку Розподіл продуктів.
- Виберіть значок Додаткові параметри та виберіть Експорт CSV або Експорт JSON.Файл завантажено.Докладніше про формати експорту.
Імпорт моделі розподілу продукту
Ви можете експортувати дані, змінити їх, а потім імпортувати змінений файл. Щоб імпортувати модель розподілу продукту, виконайте наступне:
- Увійдіть до Global Admin Console та перейдіть на вкладку розподілу продукту .
- Виберіть значок Додаткові параметри та виберіть Імпорт.
- Виберіть JSON або CSV файл для передавання.
- Виберіть Переглянути очікувані зміни. Після перегляду виберіть Надіслати зміни, щоб виконати їх.
Формати експорту та імпорту для розподілу продукту
Формати експорту та імпорту однакові. Під час імпорту у форматі CSV поля можуть з'являтися в будь-якому порядку, але завжди повинні відповідати рядку заголовка. Під час імпорту у форматі JSON поля можуть з'являтися в будь-якому порядку.
Під час імпорту даних розподілу продукту потрібно вказати операцію. Операція може бути однією з наступних:
- Оновити: означає редагування (зміна значень grantedQuantity, allowOverAllocation).
- Створити: означає додати ресурс продукту до вказаної організації.
- Видалити: означає видалення продукту.
Якщо операцію не вказано, зміни не відбудуться під час імпорту даних для цього рядка в CSV або об'єкта в JSON.
В експортованому файлі є один рядок або запис для кожного ресурсу продукту. Деякі продукти мають більше одного ресурсу.
Якщо продукт має більше одного ресурсу, операції оновлення можуть застосовуватися до незалежних ресурсів, операція видалення видаляє продукт, включаючи всі ресурси з організації, а операція створення потребує запису для кожного з ресурсів у файлі імпорту, щоб можна було вказати відповідну кількість кожного з них. Поле allowOverAllocation стосується всього продукту, і не має значення, в якому ресурсі знаходиться оновлення цього поля.
| Назва поля | Опис | Використання |
|---|---|---|
| productName | Назва продукту. | Тільки для читання |
| licenseId | Ідентифікатор продукту (унікальний для продукту в організації). Під час додавання нового продукту це поле може бути порожнім або містити ідентифікатор-заповнювач, наприклад, new_product_1. Ідентифікатор-заповнювач використовується у випадках, коли інші імпортовані записи повинні посилатися на цей продукт. Після створення призначається фактичний ідентифікатор ліцензії, який замінює всі використання ідентифікатора-заповнювача ліцензії. |
Можна встановити, коли operation=Create |
| sourceLicenseId | Ідентифікатор батьківського продукту.Він порожній або дорівнює null, якщо це покупка, а не розподіл. | Можна встановити, коли operation=Create |
| productId | Ідентифікатор, який визначає цей клас продукту. Цей ідентифікатор є спільним для продуктів одного типу і відрізняється від licenseId, який визначає екземпляр цього продукту. | Тільки для читання |
| resourceName | Назва цього ресурсу продукту. Наприклад, ліцензії користувач. | Тільки для читання |
| resourceId | Ідентифікатор, який визначає цей ресурс продукту. | Можна встановити, коли operation=Create |
| orgPathName | Шлях до організації, в якій знаходиться цей ресурс продукту.Сегменти розділені «/». | Тільки для читання |
| orgName | Проста назва організації, що містить цей ресурс продукту.Це останній сегмент orgPathName. | Тільки для читання |
| orgId | Ідентифікатор організації, що містить цей ресурс продукту. | Можна встановити, коли operation=Create |
| grantedQuantity | Кількість одиниць ресурсу, наданих цій організації її шаблоном, або сума покупки, якщо цей запис ресурсу продукту представляє покупку. Це поле можна оновлювати, за винятком придбаних продуктів або кореневих розподілів, які глобальний адміністратор не може змінювати. |
Можна оновити, коли operation=Update або operation=Create |
| unit | Назва одиниці ресурсу.Наприклад, користувачі. | Тільки для читання |
| totalAllocations | Сума грантів дочірнім організаціям від цієї організації для цього ресурсу продукту.Це значення включає прямі гранти безпосереднім дочірнім організаціям плюс надлишкові розподіли від цих організацій.Наприклад, якщо ця організація надала дочірній 10, а дочірня потім розподілила своїй дочірній 25, totalAllocations становитиме 25: 10, наданих дочірній, плюс перевищення в 15 у цій дочірній. | Тільки для читання |
| grantOverage | Обсяг, на який totalAllocations перевищує grantedQuantity.Якщо totalAllocations не перевищує grantedQuantity, це значення дорівнює null або нулю. | Тільки для читання |
| localLicensedQuantity | Обсяг цього ресурсу, наданого цій організації, який залишився для її використання після вирахування кількості, розподіленої дочірнім організаціям.Це обсяг, показаний як доступний в консолі Admin Console.Це значення може дорівнювати нулю, але ніколи не буває від'ємним, навіть якщо ця організація надмірно розподілила ресурси своїм дочірнім організаціям. | Тільки для читання |
| localUsage | Кількість одиниць ресурсу, використаних у цій організації.Наприклад, делегування ліцензії користувача користувачу вважається 1 одиницею використання. | Тільки для читання |
| totalUsage | Кількість одиниць ресурсу, використаних цією організацією та всіма дочірніми організаціями.Це показує використання цього ресурсу в частині ієрархії організації, корінь якої знаходиться в цій організації. | Тільки для читання |
| useOverage | Обсяг загального використання понад ліміт організації (організація та дочірні організації використали більше ресурсу, ніж доступно).Це показує ненульове значення, коли totalUsage перевищує localLicensedQuantity, | Тільки для читання |
| allowOverAllocation | Вказує, чи дозволено користувачу надавати дочірнім організаціям більше ресурсів, навіть якщо більше немає що надавати (дозволено надавати попри перевищення ліміту). Це значення застосовується до всіх ресурсів цього продукту.Якщо здійснюється спроба оновити allowOverallocation для більш ніж одного ресурсу одного продукту до різних значень, результат є випадковим. | Можна оновити, коли operation=Update |
| isPurchasedProduct | true, якщо продукт є придбаним (не виділеним батьківським шаблоном).Це відповідає sourceLicenseId із порожнім значенням. | Тільки для читання |
| redistributable | true, якщо продукт можна розподілити дочірнім організаціям; false означає, що продукт доступний лише в організації, де він відображається, і ресурси не можна розподілити іншій організації. | Тільки для читання |
| operation | Одне з: порожнє, створити, оновити або видалити.Дія, яку потрібно виконати під час імпорту даних. |
Перевірка даних
- Поле operation повинно містити коректну операцію.
- Дані імпорту продукту мають містити властивості та значення для обов'язкових полів.
- Властивості даних імпорту продукту мають бути правильного типу.
- Поле політики продукту (overAllocation) не має надаватися для різних ресурсів.
- Поле grantedQuantity:
- Не можна змінити на unlimited , якщо воно ще не є unlimited.
- Має бути невід'ємним цілим числом або рядковим значенням unlimited.
Перевірка дозволів/доступу
- Організація, пов'язана з даними імпорту, має існувати.При оновленні переконайтеся, що продукт і ресурс, пов'язані з даними імпорту, дійсно існують.
Додати перевірку продукту
- SourceLicenseId має існувати.
- Організація, пов'язана з новим продуктом, має існувати.
- Продукт, який створюється, не має існувати (продукт з таким самим licenseId).
- Ресурси, пов'язані зі створюваним продуктом, повинні мати відповідний productId, який збігається з цим продуктом.
