Masuk ke Global Admin Console. Di tab Organizations , gunakan pemilih organisasi untuk memilih hierarki organisasi tempat Anda ingin melakukan ekspor. Data untuk semua organisasi dalam hierarki akan diekspor.
Last updated on
17 Jun 2025
Pelajari bagaimana admin global dapat menyederhanakan manajemen organisasi dan produk dengan fitur ekspor dan impor di Global Admin Console.
Akses tab Organizations di Global Admin Console untuk mengekspor atau mengimpor struktur organisasi, dan buka tab Product Allocation untuk data alokasi. Gunakan ikon More Options untuk memilih ekspor atau impor.
Mengekspor struktur organisasi
Sebagai admin global, Anda dapat mengekspor hierarki organisasi. Anda dapat mengunduh representasi JSON, CSV, atau XLSX dari seluruh hierarki organisasi, atau bagian tertentu saja. Kemudian Anda dapat menggunakan data ini untuk menganalisis atau melakukan modifikasi.
Format ekspor yang dipilih memengaruhi struktur data yang diekspor.
- Format CSV memungkinkan ekspor hanya satu jenis data pada satu waktu. Saat mengekspor profil produk dalam format CSV, profil dan sumber daya digabungkan ke dalam satu tabel. Ada beberapa entri untuk profil produk, satu untuk setiap sumber daya.
- Format XLSX menghasilkan setiap detail organisasi ditampilkan dalam sheet terpisah.
Rekam dihubungkan antara berbagai jenis objek dengan ID referensi. Dalam beberapa kasus, mungkin ada beberapa baris untuk objek tertentu, seperti dalam kasus objek Resource ketika ada sekumpulan nilai yang terkait dengan sumber daya tertentu.
- Format JSON adalah yang paling fleksibel. Format ini dapat memanfaatkan hubungan struktural antara objek yang diekspor. Misalnya, produk dalam organisasi muncul langsung di elemen organisasi. Field yang sama diekspor dalam ketiga format tetapi beberapa nilai berlebihan dalam format JSON.
Pilih ikon More Options dan pilih Export.
Di kotak dialog Export , pilih apa yang akan diekspor dan format untuk mengekspor data.
Pilih Export. File ekspor dapat membutuhkan beberapa menit untuk dihasilkan. Setelah selesai, untuk mengunduh laporan, navigasikan ke Global Admin Console > Insights > Export Reports. Pelajari selengkapnya tentang fitur Export Reports.
Note
File JSON diekspor dalam format zip. Anda dapat membukanya menggunakan utilitas zip atau fitur zip sistem operasi.
Setelah mengunduh file, Anda dapat memanipulasi data, lalu mengimpornya kembali. Pembaruan yang diimpor akan muncul di Global Admin Console seolah-olah Anda telah mengedit data secara manual.
Impor struktur organisasi
Sebagai global administrator, Anda dapat mengimpor data yang berpotensi telah dimodifikasi. Ketika diunggah, data baru akan dibandingkan dengan data saat ini dan perubahan apa pun akan diterapkan pada hierarki organisasi. Semua operasi impor dilakukan pada salinan terbaru hierarki organisasi. Jika Anda memiliki perubahan yang tertunda, perubahan impor akan ditambahkan di atas perubahan tertunda dalam hierarki.
Masuk ke Global Admin Console. Di tab Organizations , gunakan pemilih organisasi untuk memilih hierarki organisasi tempat Anda ingin melakukan impor.
Pilih ikon More Options 
dan pilih Import. Tergantung pada ukuran dan kompleksitas file impor, pemrosesan dapat berlangsung dari beberapa detik hingga beberapa menit.
Pilih Select a file, dan pilih file JSON, CSV, atau XLSX yang akan diunggah. Untuk CSV, hanya satu detail organisasi yang dapat diimpor pada satu waktu dan tidak mendukung impor Produk.
Perubahan yang diimpor muncul seolah-olah Anda telah mengedit data secara manual.
Pilih Tutup.
Pilih Review Pending Changes. Kemudian, pilih Submit Changes untuk execute.
Sebelum menjalankan perubahan, tindakan yang tertunda ditampilkan dengan cara yang sama seperti saat pengeditan dilakukan secara manual di Global Admin Console.
Skema ekspor dan impor
Saat mengimpor data menggunakan file CSV, kolom dapat muncul dalam urutan apa pun tetapi harus selalu cocok dengan baris header.
Saat mengimpor data, Anda harus menentukan operasi untuk setiap elemen. Operasi dapat berupa salah satu dari berikut:
- Update: menunjukkan pengeditan.
- Create: menunjukkan pembuatan objek baru (Misalnya, organisasi, grup pengguna, atau admin).
- Delete: menunjukkan penghapusan objek (Misalnya, organisasi, grup pengguna, atau admin).
Catatan input tanpa atau dengan kolom operasi kosong akan diabaikan.
| Nama Bidang | Deskripsi | Catatan |
|---|---|---|
| id | ID Organisasi. Saat menambahkan organisasi baru, ini dapat dikosongkan atau disetel ke pengenal placeholder, misalnya, new_org_1. Pengenal placeholder digunakan dalam kasus di mana entri impor lain perlu merujuk ke organisasi ini. Setelah dibuat, id organisasi aktual akan ditetapkan dan menggantikan semua penggunaan id organisasi placeholder. |
Dapat disetel ke nilai sementara ketika operation=create |
| nama | Nama sederhana organisasi. Panjang minimum 4, maksimum 100. Nama dapat berisi karakter UTF-8hingga 3-byte, karakter 4-byte tidak didukung. |
Dapat disetel atau diperbarui ketika operation=create atau operation=update |
| countryCode | Kode negara atau wilayah | Harus disetel ketika operation=create, dapat diperbarui ketika operation=Update |
| type | Jenis organisasi | Hanya Baca |
| parentOrgId | ID organisasi induk. Kosong untuk organisasi root. Saat memperbarui, pembatasan signifikan berlaku termasuk induk baru harus berada dalam hierarki yang sama dan memiliki produk yang ada dalam organisasi. |
Dapat disetel atau diperbarui ketika operation=create atau operation=update |
| adminCount | Jumlah admin | Hanya Baca |
| domainCount | Jumlah domain | Hanya Baca |
| userCount | Jumlah pengguna | Hanya Baca |
| userGroupCount | Jumlah grup pengguna | Hanya Baca |
| admin | Kumpulan objek admin yang mewakili admin untuk organisasi ini |
Mungkin tidak ada jika tidak dipilih untuk diekspor. Ditampilkan dalam tab terpisah di file XLSX. |
| domains | Kumpulan objek domain yang mewakili domain dalam organisasi ini |
|
| products | Kumpulan objek produk yang mewakili produk dalam organisasi ini |
|
| productProfiles | Kumpulan objek profil produk yang mewakili profil produk dalam organisasi ini |
|
| userGroups | Kumpulan objek grup pengguna yang mewakili grup pengguna dalam organisasi ini |
|
| orgPolicies | Struktur yang mewakili kebijakan dan nilainya | |
| operation | Salah satu dari kosong, Create, Update, atau Delete. Tindakan yang akan diambil saat data diimpor. | Selalu kosong saat ekspor. |
Persyaratan impor:
- Untuk update atau delete, orgId harus merujuk ke organisasi yang sudah ada dalam hierarki Anda.
- Jika Anda membuat organisasi baru, Anda dapat membiarkan field orgId kosong atau mengisinya dengan id unik yang Anda buat sendiri, seperti new-1, atau new-2. Ini menyediakan id yang dapat digunakan untuk merujuk ke organisasi yang akan dibuat.
- Kode negara harus valid.
- orgId untuk operasi Update dan Delete harus sudah ada dalam hierarki organisasi.
- orgId yang ditandai sebagai Delete tidak boleh dipilih sebagai parentOrgId untuk organisasi dengan operasi Update atau Create .
- Organisasi anak pada level yang sama dan dari induk yang sama tidak boleh memiliki orgName yang sama.
- Untuk membuat organisasi atau memperbarui nama organisasi, nama organisasi tidak boleh sama dengan nama anak yang sudah ada dari induk yang sama.
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| orgId | Referensi ke organisasi tempat admin berada. | Digunakan sebagai referensi untuk menemukan objek yang terkandung atau terkait. |
| firstName | Nama depan pengguna admin. Nama depan dan belakang untuk pengguna Adobe ID dapat diganti dengan nilai yang disediakan pengguna ketika pengguna menerima undangan. |
Dapat diatur atau diperbarui ketika operation=create atau operation=update, masing-masing |
| lastName | Nama belakang pengguna admin | |
| Alamat email pengguna admin. Ini adalah kunci utama untuk pengguna dan harus unik. | ||
| countryCode | Kode negara atau wilayah tempat pengguna beroperasi. Hanya berlaku untuk jenis Federated dan Enterprise ID. |
|
| userType | Salah satu dari "Adobe ID", "Enterprise ID", atau "Federated ID". | Hanya Baca |
| adminType | Salah satu dari "GLOBAL ADMIN", "GLOBAL VIEWER", "SYSTEM ADMIN", "USER GROUP ADMIN", "PRODUCT ADMIN", "PRODUCT PROFILE ADMIN", "DEPLOYMENT ADMIN", dan "STORAGE_ADMIN". | Dapat diatur saat operation=Create |
| groupId | ID grup dari grup yang menjadi admin pengguna ini. Relevan hanya untuk admin grup pengguna dan profil produk. | |
| licenseId | ID lisensi produk dari produk yang menjadi admin pengguna ini. Relevan hanya untuk admin produk. | |
| domain | Nama domain pengguna jika tidak menggunakan domain email | |
| userName | Nama pengguna jika tidak menggunakan alamat email | |
| operation | Salah satu dari kosong, Create, Update, atau Delete. Tindakan yang akan diambil saat data diimpor. |
Persyaratan impor:
- orgId, email, adminType, dan userType harus berisi nilai yang valid.
- countryCode harus valid.
- Jika pengguna sudah ada dan sedang diperbarui, userType harus cocok dengan pengguna.
- Periksa alamat email duplikat dalam organisasi.
Ekspor dan impor profil produk terdiri dari dua bagian: detail profil produk, dan sekumpulan sumber daya yang terkait dengan profil produk. Sumber daya ini mengidentifikasi layanan yang dapat dikonfigurasi, biasanya hanya untuk mengaktifkan atau menonaktifkannya.
- Objek sumber daya disarangkan dalam profil produk dalam format JSON.
- Saat menggunakan CSV atau XLSX dengan profil produk, profil dan sumber daya digabungkan menjadi satu tabel. Akan ada beberapa entri untuk profil produk, satu untuk setiap sumber daya.
- Bidang "selected" dalam sumber daya mengontrol apakah layanan diaktifkan.
- Saat mengimpor profil produk, harus ada operasi Create atau Update pada profil produk itu sendiri dan pada objek sumber daya apa pun yang akan diperbarui atau dibuat.
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| productProfileId | Identifier profil produk Nilai placeholder dapat digunakan pada create sehingga objek lain dapat merujuk profil baru. |
Dapat diatur ke nilai sementara saat operation=create |
| productProfileName | Nama profil produk. Tidak dapat menjadi duplikat dari profil produk atau grup pengguna lain dalam organisasi yang sama. |
Dapat diatur atau diperbarui saat operation=create atau operation=update |
| productProfileDescription | Deskripsi teks profil produk | |
| licenseId | Referensi License Id ke produk | Digunakan sebagai referensi untuk menemukan objek yang berisi atau terkait |
| orgId | Organisasi yang berisi grup pengguna | |
| pemberitahuan | True atau false untuk menunjukkan apakah notifikasi email harus dikirim ke pengguna saat mereka ditambahkan atau dihapus dari profil produk ini | Dapat diatur atau diperbarui saat operation=create atau operation=update |
| resources | Array sumber daya yang terkait dengan profil produk ini. Field resources hanya ada untuk format JSON. Untuk format CSV dan XLSX, sumber daya diwakili dengan field tambahan berikut: resourceName, resourceId, resourceDescription, icon, selected, kuota, resourceType. Untuk detail tentang field ini, lihat Products and Resources. Jika profil produk memiliki lebih dari satu sumber daya, akan ada beberapa baris, satu untuk setiap sumber daya. Field lainnya akan memiliki nilai yang sama untuk setiap resource. |
|
| operasi | Salah satu dari kosong, Create, Update atau Delete. Tindakan yang akan diambil saat data diimpor. |
Persyaratan impor:
- productProfileId, licenseId dan orgId harus memiliki nilai yang valid.
- Saat membuat profil produk, productProfileName harus berupa nama yang valid dan tidak boleh menduplikat nama profil produk lain atau nama grup pengguna lain dalam organisasi yang sama.
- Field kuota harus memiliki nilai yang valid untuk jenis unit. Ini berupa angka atau "unlimited" saat resourceType=QUOTA atau kosong jika sebaliknya.
- Field notifikasi harus berupa true atau false.
- Untuk impor CSV dan XLSX, validasi productProfileId, semua entrinya harus memiliki orgId, licenseId, dan productProfileName yang sama.
- Validasi duplikat productProfileName dalam file input dan organisasi.
- Profil yang akan diperbarui dan dihapus harus ada dalam organisasi.
- Resource yang akan diperbarui dan dihapus (dinonaktifkan) harus ada dalam profil.
- Untuk profil yang akan dibuat, pastikan hal berikut:
- orgId harus berupa organisasi baru atau organisasi yang sudah ada.
- licenseId harus berupa produk baru atau produk yang sudah ada.
- Validasi resource untuk profil.
Resource dalam profil produk:
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| resourceName | Nama resource | Hanya Baca |
| resourceId | Pengenal resource | Hanya Baca |
| resourceDescription | Deskripsi teks sumber | Hanya Baca |
| ikon | URL ke Citra untuk sumber | Hanya Baca |
| dipilih | Untuk entri konfigurasi, apakah fitur diaktifkan. Kolom ini hanya ada dalam JSON. |
Dapat diatur atau diperbarui ketika operation=create atau operation=update |
| kuota | Kuantitas sumber utama yang dapat diberikan kepada pengguna melalui profil produk ini. Kolom ini hanya ada dalam JSON. |
|
| resourceType | Jika ada, nilainya adalah SERVICE. Ini menunjukkan sumber ini mewakili layanan yang dapat diaktifkan atau dinonaktifkan berdasarkan nilai kolom yang dipilih. Kolom ini hanya ada dalam JSON. |
Hanya Baca |
| operation | Salah satu dari kosong, Create, Update, atau Delete. Tindakan yang diambil ketika data diimpor. |
Persyaratan impor:
Kolom operasi pada sumber diabaikan ketika profil produk yang dimilikinya memiliki operasi yang diatur sebagai Delete atau Create.
- Tidak ada sumber yang boleh ditandai untuk penghapusan, ini adalah operasi yang tidak valid.
- Agar profil produk dapat dibuat, jumlah sumber daya harus cocokkan dengan jumlah sumber daya profil produk sumber.
- Untuk sumber daya dengan operasi Perbarui , sumber daya harus ada dalam profil produk.
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| userGroupId | Pengenal grup pengguna Nilai placeholder dapat digunakan saat membuat sehingga objek lain dapat mereferensikan grup pengguna baru. |
Dapat diatur ke nilai sementara ketika operation=create |
| userGroupName | Nama grup pengguna | Dapat diatur atau diperbarui ketika operation=create atau operation=update |
| userGroupDescription | Deskripsi teks grup pengguna | |
| userCount | Jumlah pengguna dalam grup pengguna | Hanya Baca |
| profil | Array ID profil produk yang terkait dengan grup pengguna. XLSX memiliki satu baris per nilai dengan nilai yang sama untuk kolom lainnya. |
Dapat diatur atau diperbarui ketika operation=create atau operation=update |
| orgId | Organisasi yang berisi grup pengguna | Digunakan sebagai referensi untuk menemukan objek yang berisi atau terkait. |
| operation | Salah satu dari kosong, Create, Update atau Delete.Tindakan yang akan diambil saat data diimpor. |
Persyaratan impor:
- orgId harus merujuk pada organisasi yang sudah ada atau organisasi yang sedang dibuat dalam impor yang sama.
- userGroupId harus merujuk pada grup yang sudah ada untuk pembaruan atau penghapusan, dan dapat berupa id yang Anda tentukan untuk grup pengguna baru.
- Untuk pembaruan atau pembuatan, userGroupNameorganization tidak boleh kosong dan tidak boleh menduplikasi nama grup pengguna atau profil produk lain dalam organisasi yang sama.
- Pastikan userGroupName tidak duplikat dalam file input dan organisasi.
- userGroups yang akan diperbarui atau dihapus harus ada dalam organisasi.
- Profil yang akan dihapus dari grup pengguna harus ada dalam grup pengguna tersebut.Operasi pembaruan tidak dapat dilakukan pada profil grup pengguna.
- Untuk grup pengguna yang akan dibuat, pastikan hal berikut:
- orgId harus berupa organisasi baru atau organisasi yang sudah ada.
- licenseId, jika berlaku, harus berupa produk baru atau produk yang sudah ada.
- productProfileId harus berupa profil produk baru atau profil produk yang sudah ada.
Informasi domain menyediakan informasi Hanya Baca tentang domain yang tersedia di setiap organisasi.Data ini tidak dapat diedit.
|
Nama Bidang |
Deskripsi |
Gunakan |
|---|---|---|
|
orgId |
Referensi ke organisasi tempat domain ini tercantum |
Digunakan sebagai referensi untuk menemukan objek yang berisi atau terkait. |
|
domainName |
Nama domain, misalnya, adobe.com. |
Hanya Baca |
|
directoryName |
Nama direktori tempat domain tercantum |
Hanya Baca |
|
directoryType |
Salah satu dari Federated ID atau Enterprise ID. |
Hanya Baca |
|
domainStatus |
Salah satu dari "ACTIVE", "RESERVED", "UNCLAIMED", "CLAIMED", "VALIDATED", "WITHDRAWN", "ACTIVE", "EXPIRED". |
Hanya Baca |
Dalam file XLSX, terdapat dua lembar- satu untuk produk dan satu untuk resource.Dalam JSON, objek resource ditumpangkan dalam objek produk.
Produk:
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| licenseId | id yang mengidentifikasi produk.Setiap produk memiliki id lisensi unik dalam organisasi tempat produk tersebut terdaftar. Id lisensi untuk produk yang sama akan berbeda di organisasi yang berbeda.Saat menambahkan produk baru, ini dapat dikosongkan atau menggunakan pengenal placeholder, misalnya, new_product_1.Pengenal placeholder digunakan dalam kasus di mana entri impor lain perlu merujuk ke instance produk ini.Setelah pembuatan, id lisensi aktual akan ditetapkan yang menggantikan semua penggunaan id lisensi placeholder. |
Dapat diatur ke nilai sementara ketika operation=create |
| productName | Nama produk | Hanya Baca |
| productDescription | Deskripsi teks produk | Hanya Baca |
| allowOverallocation | Boolean yang menunjukkan apakah overallocation dari instance produk ini diizinkan. Overallocation merujuk pada kemampuan untuk memberikan kuantitas lebih banyak kepada organisasi anak daripada yang telah Anda terima. |
Dapat diatur atau diperbarui saat operation=create atau operation=update |
| ikon | URL ikon produk | Hanya Baca |
| sourceLicenseId | ID lisensi instance produk dalam organisasi dari mana produk ini dialokasikan. Nilainya null jika instance ini bukan produk yang dialokasikan, melainkan produk yang dibeli. | Dapat diatur saat operation=Create |
| productId | Pengenal produk. | Hanya Baca |
| orgId | Pengenal organisasi yang berisi instance produk ini | Digunakan sebagai referensi untuk menemukan objek yang berisi atau terkait. |
| redistributable | Boolean yang menunjukkan apakah produk ini memiliki sumber daya yang dapat diberikan ke organisasi anak. | Hanya Baca |
| resources | objek yang berisi sekumpulan objek sumber daya yang mewakili sumber daya dan Pengaturan dalam produk ini | |
| operation | Salah satu dari kosong, Create, Update, atau Delete. Tindakan yang diambil saat data diimpor. |
Persyaratan impor:
- Untuk create, licenseId harus berupa id unik yang Anda buat.
- Untuk update, licenseId harus berupa id produk yang sudah ada dalam organisasi yang ditentukan.
- orgId harus merujuk ke organisasi yang ada atau organisasi yang sedang dibuat dalam operasi impor yang sama.
- Untuk membuat, sourceLicenseId harus merujuk ke produk yang ada atau id yang Anda tentukan untuk produk yang sedang dibuat dalam operasi impor yang sama.
- licenseId dan sourceLicenseId tidak boleh sama untuk produk dengan operasi Buat.
- Validasi organisasi produk, organisasi harus yang baru atau sudah ada dalam hierarki organisasi.
- Untuk operasi Perbarui dan Hapus, produk sudah harus ada dalam hierarki organisasi.
- licenseId yang ditandai sebagai Hapus tidak boleh digunakan sebagai sourceLicenseId produk dengan operasi Buat dan Perbarui.
- Untuk produk dengan operasi Buat, validasi bahwa sourceLicenseId harus ada dalam organisasi induk.
Sumber daya untuk produk:
Objek sumber daya dapat muncul dalam produk dan dalam profil produk.
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| resourceName | Nama sumber daya | Hanya Baca |
| resourceId | Pengenal sumber daya | Hanya Baca |
| resourceDescription | Deskripsi teks sumber daya | Hanya Baca |
| icon | URL ke citra untuk sumber daya | Hanya Baca |
| productName | Nama produk yang merupakan bagian dari sumber daya ini. | Hanya Baca |
| licenseId | ID lisensi (instance produk) dari produk yang menjadi bagian dari resource ini. | Digunakan sebagai referensi untuk menemukan objek yang mengandung atau terkait. |
| grantedQuantity | Kuantitas yang diberikan dari resource ini: jumlah resource yang tersedia untuk digunakan secara lokal atau dialokasikan ke organisasi anak oleh organisasi ini. | Dapat diatur atau diperbarui ketika operation=create atau operation=update |
| unit | Nama unit dari kuantitas pemberian. | Hanya Baca |
| currentQuantity | Kuantitas yang dapat digunakan saat ini dalam organisasi ini. Ini adalah grantedQuantity dikurangi resource yang dialokasikan ke organisasi anak. Ini adalah nilai yang ditampilkan di Admin Console untuk produk/resource ini. | Hanya Baca |
| provisionedQuantity | Kuantitas yang benar-benar disediakan: dapat lebih sedikit dari pemberian atau yang tersedia saat ini, dapat lebih sedikit dari currentQuantity jika ada batasan tertentu. | Hanya Baca |
| operation | Salah satu dari kosong, Create, Update, atau Delete. Tindakan yang akan diambil saat data diimpor. |
Persyaratan impor:
Field operasi pada resource diabaikan ketika produk tempat resource tersebut berada memiliki operasi yang diatur sebagai Delete atau Create.
- Tidak boleh ada resource yang ditandai untuk dihapus, ini adalah operasi yang tidak valid.
- Untuk produk yang akan dibuat, jumlah resource harus cocokkan dengan jumlah resource produk sumber.
- Untuk resource dengan operasi Update , resource tersebut harus ada dalam produk.
Impor dan ekspor data alokasi produk
Sebagai Global Administrator, Anda dapat mengekspor data alokasi produk sebagai file JSON atau CSV. Anda kemudian dapat memanipulasi data ini dan mengunggahnya kembali untuk mengimpor perubahannya. Ketika data yang berpotensi dimodifikasi diunggah, data baru dibandingkan dengan data saat ini dan perubahan apa pun diterapkan pada data alokasi produk. Anda kemudian dapat meninjau dan mengirim perubahan yang tertunda agar dapat diterapkan.
Ekspor model alokasi produk
Untuk mengekspor model alokasi produk, lakukan hal berikut:
- Masuk ke Global Admin Console dan navigasi ke tab Product Allocation .
- Pilih ikon More Options dan pilih Export CSV atau Export JSON. File Anda diunduh. Pelajari selengkapnya tentang format ekspor.
Impor model alokasi produk
Anda dapat mengekspor data, memodifikasinya, lalu mengimpor file yang dimodifikasi. Untuk mengimpor model alokasi produk, lakukan hal berikut:
- Masuk ke Global Admin Console dan navigasi ke tab Product Allocation .
- Pilih ikon More Options dan pilih Import.
- Pilih file JSON atau CSV untuk diunggah.
- Pilih Review Pending Changes. Setelah meninjau, pilih Submit Changes untuk menjalankannya.
Format ekspor dan impor untuk alokasi produk
Format ekspor dan impor adalah sama. Saat mengimpor dalam format CSV, field dapat muncul dalam urutan apa pun tetapi harus selalu cocokkan baris header mereka. Saat mengimpor dalam format JSON, field dapat muncul dalam urutan apa pun.
Anda harus menentukan operasi saat mengimpor data alokasi produk. Operasi dapat berupa salah satu dari berikut:
- Update: menunjukkan pengeditan (perubahan pada nilai grantedQuantity, allowOverAllocation).
- Create: menunjukkan penambahan sumber daya produk ke organisasi yang ditentukan.
- Delete: menunjukkan penghapusan produk.
Jika tidak ada operasi yang diberikan, maka tidak ada perubahan yang terjadi saat data diimpor untuk baris tersebut dalam CSV atau objek dalam JSON.
Dalam file yang diekspor, ada satu baris atau record untuk setiap sumber daya produk. Beberapa produk memiliki lebih dari satu sumber daya.
Jika suatu produk memiliki lebih dari satu sumber daya, operasi Update dapat diterapkan pada sumber daya independen, operasi Delete menghapus produk termasuk semua sumber daya dari organisasi, dan operasi Create memerlukan record untuk setiap sumber daya dalam file impor sehingga kuantitas yang tepat dari masing-masing dapat ditentukan. Field allowOverAllocation berlaku untuk seluruh produk dan tidak masalah di sumber daya mana pembaruan field ini berada.
| Nama Bidang | Deskripsi | Gunakan |
|---|---|---|
| productName | Nama produk. | Hanya Baca |
| licenseId | Id suatu produk (unik untuk produk dalam organisasi). Saat menambahkan produk baru, ini dapat dikosongkan atau diatur ke pengidentifikasi placeholder, misalnya, new_product_1. Pengidentifikasi placeholder digunakan dalam kasus di mana entri impor lain perlu merujuk ke produk ini. Setelah pembuatan, id lisensi aktual akan ditetapkan dan mengganti semua penggunaan id lisensi placeholder. |
Dapat diatur saat operation=Create |
| sourceLicenseId | Id produk induk. Kosong atau null jika ini merupakan pembelian bukan alokasi. | Dapat diatur ketika operation=Create |
| productId | Id yang mengidentifikasi kelas produk ini. Id ini dibagikan di antara produk dengan jenis yang sama dan berbeda dari licenseId yang mengidentifikasi instans dari produk ini. | Hanya Baca |
| resourceName | Nama sumber daya produk ini. Misalnya, Lisensi pengguna. | Hanya Baca |
| resourceId | Id yang mengidentifikasi sumber daya produk ini. | Dapat diatur ketika operation=Create |
| orgPathName | Nama jalur organisasi tempat sumber daya produk ini berada. Segmen dipisahkan oleh "/". | Hanya Baca |
| orgName | Nama sederhana organisasi yang berisi sumber daya produk ini. Ini adalah segmen akhir dari orgPathName. | Hanya Baca |
| orgId | Id Organisasi dari organisasi yang berisi sumber daya produk ini. | Dapat diatur ketika operation=Create |
| grantedQuantity | Jumlah unit kuantitas sumber daya yang diberikan kepada organisasi ini oleh induknya atau jumlah yang dibeli jika entri sumber daya produk ini mewakili pembelian. Bidang ini dapat diperbarui kecuali untuk produk yang dibeli atau alokasi root yang tidak memiliki izin untuk diubah oleh admin global. |
Dapat diperbarui saat operation=Update atau operation=Create |
| unit | Nama unit sumber daya. Misalnya, Pengguna. | Hanya Baca |
| totalAllocations | Jumlah hibah kepada organisasi anak dari organisasi ini untuk sumber daya produk ini. Nilai ini mencakup hibah langsung kepada anak langsung ditambah overalokasi dari organisasi tersebut. Misalnya, jika organisasi ini memberikan anak 10 dan anak tersebut kemudian mengalokasikan anaknya 25, totalAllocations akan menjadi 25: 10 yang diberikan kepada anak ditambah kelebihan 15 pada anak tersebut. | Hanya Baca |
| grantOverage | Jumlah di mana totalAllocations melebihi grantedQuantity. Jika totalAllocations tidak melebihi grantedQuantity, nilai ini null atau nol. | Hanya Baca |
| localLicensedQuantity | Jumlah sumber daya ini yang diberikan kepada organisasi ini yang tersisa untuk penggunaannya setelah kuantitas yang dialokasikan kepada anak-anak dikurangi. Ini adalah jumlah yang ditampilkan sebagai tersedia di Admin Console. Nilai ini dapat nol tetapi tidak pernah negatif meskipun organisasi ini telah mengalokasikan sumber daya secara berlebihan kepada anak-anaknya. | Hanya Baca |
| localUsage | Jumlah unit sumber daya yang digunakan dalam organisasi ini. Misalnya, mendelegasikan Lisensi Pengguna ke pengguna akan dihitung sebagai 1 unit penggunaan. | Hanya Baca |
| totalUsage | Jumlah unit sumber daya yang digunakan oleh organisasi ini dan semua anak organisasi. Ini menunjukkan penggunaan sumber daya ini di bagian hierarki organisasi yang berakar dari organisasi ini. | Hanya Baca |
| useOverage | Jumlah total penggunaan yang melebihi pemberian lisensi organisasi (organisasi dan anak organisasi telah menggunakan sumber daya lebih dari yang tersedia). Ini menunjukkan nilai bukan nol ketika totalUsage melebihi localLicensedQuantity, | Hanya Baca |
| allowOverAllocation | Menunjukkan apakah pengguna diizinkan untuk memberikan lebih banyak sumber daya kepada anak organisasi meskipun tidak ada lagi yang dapat diberikan (diizinkan memberikan meskipun terjadi kelebihan pemberian lisensi) Nilai ini berlaku untuk semua sumber daya produk ini. Jika ada upaya untuk memperbarui allowOverallocation untuk lebih dari satu sumber daya produk yang sama dengan nilai yang berbeda, hasilnya akan acak. | Dapat diperbarui ketika operation=Update |
| isPurchasedProduct | true jika produk adalah produk pembelian (tidak dialokasikan oleh induk). Ini setara dengan sourceLicenseId yang memiliki nilai kosong. | Hanya Baca |
| redistributable | true jika produk dapat dialokasikan ke anak organisasi, false berarti produk hanya tersedia di organisasi tempat produk ditampilkan dan sumber daya tidak dapat dialokasikan ke organisasi lain. | Hanya Baca |
| operation | Salah satu dari kosong, Create, Update atau Delete. Tindakan yang harus dilakukan ketika data diimpor. |
Validasi data
- Field operasi harus memiliki operasi yang valid.
- Data impor produk harus memiliki properti dan nilai untuk field yang diperlukan.
- Properti data impor produk harus memiliki tipe yang benar.
- Field kebijakan produk (overAllocation) tidak boleh disediakan untuk resource yang berbeda.
- Field grantedQuantity:
- Tidak dapat diubah ke unlimited jika belum unlimited.
- Harus berupa bilangan bulat non-negatif atau nilai string unlimited.
Validasi izin/aksesibilitas
- Organisasi yang terkait dengan data impor harus ada. Jika Anda melakukan update, pastikan produk dan resource yang terkait dengan data impor benar-benar ada.
Validasi penambahan produk
- SourceLicenseId harus ada.
- Organisasi yang terkait dengan produk baru harus ada.
- Produk yang dibuat tidak boleh ada (produk dengan licenseId yang sama).
- Resource yang terkait dengan produk yang sedang dibuat harus memiliki productId yang sesuai dengan produk tersebut.
