Eksport atau import struktur organisasi dan peruntukan produk

Terakhir dikemas kini pada 17 Jun 2025

Ketahui cara pentadbir global boleh memudahkan pengurusan organisasi dan produk dengan ciri eksport dan import dalam Global Admin Console.

Akses tab Organizations dalam Global Admin Console untuk mengeksport atau mengimport struktur organisasi, dan buka tab Product Allocation untuk data peruntukan.Gunakan ikon More Options untuk memilih eksport atau import.

Eksport struktur organisasi

Sebagai pentadbir global, anda boleh mengeksport hierarki organisasi. Anda boleh muat turun perwakilan JSON, CSV atau XLSX bagi keseluruhan hierarki organisasi, atau subset daripadanya. Anda kemudiannya boleh menggunakan data ini untuk menganalisis atau membuat pengubahsuaian.

Format eksport yang dipilih memberi kesan kepada struktur data yang dieksport.

  • Format CSV membenarkan mengeksport hanya satu jenis data pada satu masa. Apabila mengeksport profil produk dalam format CSV, profil dan sumber digabungkan menjadi satu jadual. Terdapat pelbagai entri untuk profil produk, satu untuk setiap sumber.
  • Format XLSX menghasilkan setiap butiran organisasi dipaparkan dalam helaian yang berasingan.
    Rekod dihubungkan antara jenis objek yang berbeza melalui id rujukan. Dalam sesetengah kes, mungkin terdapat pelbagai baris untuk objek tertentu, seperti dalam kes objek Sumber apabila terdapat set nilai yang berkaitan dengan sumber yang diberikan.
  • Format JSON adalah yang paling fleksibel. Ia boleh memanfaatkan hubungan struktur antara objek yang dieksport. Sebagai contoh, produk dalam organisasi muncul secara langsung dalam elemen organisasi. Medan yang sama dieksport dalam ketiga-tiga format tetapi sesetengah nilai adalah berlebihan dalam format JSON.

Log masuk ke Global Admin Console. Dalam tab Organisasi , gunakan pemilih organisasi untuk memilih hierarki organisasi tempat anda mahu melakukan pengeksportan. Data untuk semua organisasi dalam hierarki dieksport.

Pilih ikon Pilihan Lagi dan pilih Eksport.

Tambah organisasi

Dalam kotak dialog Eksport , pilih apa yang hendak dieksport dan format untuk mengeksport data.

Eksport data organisasi

Pilih Eksport. Fail eksport boleh mengambil masa beberapa minit untuk dijana. Setelah selesai, untuk memuat turun laporan, navigasi ke Global Admin Console > Insights > Export Reports. Ketahui lebih lanjut tentang ciri Laporan Eksport.

Nota

Fail JSON dieksport dalam format zip. Anda boleh membukanya menggunakan utiliti zip atau ciri zip sistem pengendalian.

Selepas memuat turun fail, anda boleh mengolah data, kemudian mengimportnya semula. Kemas kini yang diimport muncul dalam Global Admin Console seolah-olah anda telah mengedit data secara manual.

Import struktur organisasi

Sebagai pentadbir global, anda boleh mengimport data yang berpotensi diubah suai. Apabila dimuat naik, data baharu dibandingkan dengan data semasa dan sebarang perubahan digunakan pada hierarki organisasi. Semua operasi import dilakukan pada salinan terkini hierarki organisasi. Jika anda mempunyai sebarang perubahan yang belum selesai, perubahan import akan ditambah di atas perubahan yang belum selesai dalam hierarki.

Log masuk ke Global Admin Console. Dalam tab Organizations , gunakan pemilih organisasi untuk memilih hierarki organisasi tempat anda mahu melakukan import.

Pilih ikon More Options dan pilih Import. Bergantung pada saiz dan kerumitan fail import, pemprosesan boleh mengambil masa dari beberapa saat hingga beberapa minit.

Pilih Select a file, dan pilih fail JSON, CSV, atau XLSX untuk dimuat naik. Untuk CSV, hanya satu butiran organisasi boleh diimport pada satu masa dan ia tidak menyokong pengimportan Produk.

Perubahan yang diimport muncul seolah-olah anda telah mengedit data secara manual.

Pilih Close.

Pilih Review Pending Changes. Kemudian, pilih Submit Changes untuk melaksanakan perubahan tersebut.

Sebelum melaksanakan perubahan, tindakan yang belum selesai dipaparkan dengan cara yang sama seperti ketika suntingan dibuat secara manual dalam Global Admin Console.

Skema eksport dan import

Semasa mengimport data menggunakan fail CSV, medan boleh muncul dalam sebarang susunan tetapi mesti sentiasa sepadan dengan baris pengepala mereka. 

Semasa mengimport data, anda mesti menyatakan operasi untuk setiap elemen. Operasi boleh menjadi mana-mana satu daripada yang berikut:

  • Update: menunjukkan suntingan.
  • Create: menunjukkan penciptaan objek baharu (Contohnya, organisasi, kumpulan pengguna, atau pentadbir).
  • DELETE: menunjukkan pemadaman objek (Contohnya, organisasi, kumpulan pengguna, atau pentadbir).

Rekod input tanpa medan operasi atau medan operasi kosong diabaikan.

Nama Medan Penerangan Nota
id

Id Organisasi.

Apabila menambah organisasi baharu, ini boleh kosong atau ditetapkan kepada pengecam pemegang tempat, contohnya, new_org_1. Pengecam pemegang tempat digunakan dalam kes di mana entri import lain perlu merujuk kepada organisasi ini. Selepas penciptaan, id organisasi sebenar akan ditetapkan dan menggantikan semua penggunaan id organisasi Pemegang tempat.

Boleh ditetapkan kepada nilai sementara apabila operation=create
nama Nama ringkas organisasi. Panjang minimum 4, maksimum 100.Nama boleh mengandungi aksara UTF-8 sehingga 3-bait, aksara 4-bait tidak disokong.
Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
countryCode Kod negara atau wilayah Mesti ditetapkan apabila operation=create, boleh dikemas kini apabila operation=Update
jenis Jenis organisasi Baca sahaja
parentOrgId

Id organisasi induk. Kosong untuk organisasi akar.

Semasa mengemas kini, sekatan ketara dikenakan termasuk induk baharu mesti berada dalam hierarki yang sama dan mempunyai produk yang terdapat dalam organisasi.

Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
adminCount Bilangan pentadbir Baca sahaja
domainCount Bilangan domain Baca sahaja
userCount Bilangan pengguna Baca sahaja
userGroupCount Bilangan kumpulan pengguna Baca sahaja
pentadbir Set objek pentadbir yang mewakili pentadbir untuk organisasi ini
Mungkin tiada jika tidak dipilih untuk eksport. Ia dipaparkan dalam tab berasingan dalam fail XLSX.
domains Set objek domain yang mewakili domain dalam organisasi ini
products Set objek produk yang mewakili produk dalam organisasi ini
productProfiles Set objek profil produk yang mewakili profil produk dalam organisasi ini
userGroups Set objek kumpulan pengguna yang mewakili kumpulan pengguna dalam organisasi ini
orgPolicies Struktur yang mewakili dasar dan nilainya
operation Salah satu daripada kosong, Create, Update atau Delete. Tindakan yang perlu diambil apabila data diimport. Sentiasa kosong semasa eksport.

 

Keperluan import:

  • Untuk update atau padam, orgId mesti merujuk kepada organisasi sedia ada dalam hierarki anda.
  • Jika anda mencipta organisasi baharu, anda boleh biarkan medan orgId kosong atau tetapkan kepada id unik yang boleh anda buat, seperti new-1, atau new-2. Ini memberikan id yang boleh digunakan untuk merujuk kepada organisasi yang akan diwujudkan.
  • Kod negara hendaklah sah.
  • orgId untuk operasi Kemas Kini dan Padam sepatutnya sudah ada dalam hierarki organisasi.
  • orgId yang ditandai sebagai Padam tidak sepatutnya dipilih sebagai parentOrgId untuk organisasi dengan operasi Kemas Kini atau Cipta .
  • Organisasi anak pada tahap yang sama dan daripada induk yang sama tidak sepatutnya mempunyai orgNames yang sama.
  • Untuk mencipta organisasi atau mengemas kini nama organisasi, nama organisasi tidak boleh sama dengan nama anak sedia ada daripada induk yang sama.
Nama Medan Penerangan Guna
orgId Rujukan kepada organisasi di mana pentadbir tinggal. Digunakan sebagai rujukan untuk mencari objek yang mengandungi atau berkaitan.
firstName

Nama pertama pengguna pentadbir.

Nama Pertama dan Nama Akhir untuk pengguna Adobe ID boleh digantikan dengan nilai yang dibekalkan pengguna apabila pengguna menerima jemputan.

Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
lastName Nama akhir pengguna pentadbir
e-mel Alamat e-mel pengguna pentadbir. Ini adalah kunci utama untuk pengguna dan mesti unik.
countryCode Kod negara atau wilayah tempat pengguna beroperasi. Hanya terpakai untuk jenis Federated dan Enterprise ID.
userType Salah satu daripada "Adobe ID", "Enterprise ID", atau "Federated ID". Baca sahaja
adminType Salah satu daripada "GLOBAL ADMIN", "GLOBAL VIEWER", "SYSTEM ADMIN", "USER GROUP ADMIN", "PRODUCT ADMIN", "PRODUCT PROFILE ADMIN", "DEPLOYMENT ADMIN", dan "STORAGE_ADMIN". Boleh ditetapkan apabila operasi=Create
groupId Id kumpulan bagi kumpulan yang pentadbir pengguna ini mentadbir.Berkaitan untuk pentadbir kumpulan pengguna dan profil produk sahaja.
licenseId Id lesen produk bagi produk yang pentadbir pengguna ini mentadbir.Berkaitan untuk pentadbir produk sahaja.
domain Nama domain pengguna jika tidak menggunakan domain e-mel
userName Nama pengguna jika tidak menggunakan alamat e-mel
operation Salah satu daripada kosong, Cipta, Kemas Kini atau Padam.Tindakan yang perlu diambil apabila data diimport.  

Keperluan import:

  • orgId, e-mel, adminType dan userType mesti mengandungi nilai yang sah.
  • countryCode mesti sah.
  • Jika pengguna sudah wujud dan sedang dikemas kini, userType mesti sepadan dengan pengguna.
  • Semak alamat e-mel pendua dalam organisasi.

Eksport dan import profil produk terdiri daripada dua bahagian: butiran profil produk, dan set sumber yang dikaitkan dengan profil produk.Sumber ini mengenal pasti perkhidmatan yang boleh dikonfigurasikan, biasanya hanya untuk membolehkan atau melumpuhkannya.

  • Objek sumber bersarang dalam profil produk dalam format JSON.
  • Apabila menggunakan CSV atau XLSX dengan profil produk, profil dan sumber digabungkan menjadi satu jadual.Akan ada pelbagai entri untuk profil produk, satu untuk setiap sumber.
  • Medan "dipilih" dalam sumber mengawal sama ada perkhidmatan diaktifkan.
  • Semasa mengimport profil produk, mesti ada operasi Cipta atau Kemas kini pada profil produk itu sendiri dan pada mana-mana objek sumber yang akan dikemas kini atau dicipta.
Nama Medan Penerangan Guna
productProfileId

Pengecam profil produk

Nilai Pemegang tempat boleh digunakan pada cipta supaya objek lain boleh merujuk profil baharu.

Boleh ditetapkan kepada nilai sementara apabila operation=create
productProfileName Nama profil produk. Ia tidak boleh merupakan pendua profil produk lain atau kumpulan pengguna dalam organisasi yang sama.
Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
productProfileDescription Penerangan teks profil produk
licenseId Rujukan ID lesen untuk produk Digunakan sebagai rujukan untuk mencari objek yang mengandungi atau berkaitan
orgId Organisasi yang mengandungi kumpulan pengguna
notifications Benar atau palsu untuk menunjukkan sama ada pemberitahuan e-mel patut dihantar kepada pengguna apabila mereka ditambah atau dikeluarkan daripada profil produk ini Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
resources

Susunan sumber yang berkaitan dengan profil produk ini.

Medan sumber hanya hadir untuk format JSON. Untuk format CSV dan XLSX, sumber diwakili dengan medan tambahan berikut: resourceName, resourceId, resourceDescription, icon, selected, kuota, resourceType. Untuk butiran mengenai medan ini, lihat Produk dan Sumber.

Jika profil produk mempunyai lebih daripada satu sumber, akan terdapat beberapa baris, satu untuk setiap sumber. Medan lain akan mempunyai nilai yang sama untuk setiap sumber.

 
operation Salah satu daripada kosong, Cipta, Kemas Kini atau Padam. Tindakan yang perlu diambil apabila data diimport.  

Keperluan Import:

  • productProfileId, licenseId dan orgId mesti mempunyai nilai yang sah.
  • Apabila mencipta profil produk, productProfileName mesti nama yang sah dan tidak boleh menduplikasi nama profil produk lain atau nama kumpulan pengguna dalam organisasi yang sama.
  • Medan kuota mesti mempunyai nilai yang sah untuk jenis unit. Ini adalah numerik atau "tidak terhad" apabila resourceType=QUOTA atau kosong sebaliknya.
  • Medan pemberitahuan mesti benar atau palsu.
  • Untuk import CSV dan XLSX, sahkan productProfileId, semua entrinya mesti mempunyai orgId, licenseId, dan productProfileName yang sama.
  • Sahkan productProfileName pendua dalam fail input dan organisasi.
  • Profil yang akan dikemas kini dan dipadamkan mesti wujud dalam organisasi.
  • Sumber yang akan dikemas kini dan dipadamkan (dinyahaktifkan) mesti wujud dalam profil.
  • Untuk profil yang akan dicipta, pastikan perkara berikut:
    • orgId hendaklah organisasi baharu atau organisasi sedia ada.
    • licenseId hendaklah merupakan produk baharu atau produk sedia ada.
    • Sahkan sumber untuk profil.

Sumber dalam profil produk:

Nama Medan Penerangan Guna
resourceName Nama sumber Baca sahaja
resourceId Pengecam sumber Baca sahaja
resourceDescription Penerangan teks bagi sumber Baca sahaja
icon URL ke imej untuk sumber Baca sahaja
selected Untuk entri konfigurasi, sama ada ciri tersebut didayakan. Medan ini hadir dalam JSON sahaja.


Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
kuota Kuantiti sumber utama yang boleh diberikan kepada pengguna melalui profil produk ini. Medan ini hadir dalam JSON sahaja.
resourceType Jika hadir, nilai adalah SERVICE. Ia menunjukkan sumber ini mewakili perkhidmatan yang boleh didayakan atau dilumpuhkan berdasarkan nilai medan yang dipilih. Medan ini hadir dalam JSON sahaja.
Baca sahaja
operation Salah satu daripada kosong, Create, Update atau Delete. Tindakan yang diambil apabila data diimport.  

Keperluan import:

Medan operasi pada sumber diabaikan apabila profil produk yang mereka miliki mempunyai operasi ditetapkan sebagai Padam atau Cipta.

  • Tiada sumber perlu ditandakan untuk pemadaman, ia merupakan operasi yang tidak sah.
  • Untuk profil produk yang akan dicipta, bilangan sumber mestilah sepadan dengan bilangan sumber profil produk sumber.
  • Untuk sumber dengan operasi Kemas Kini , sumber mesti wujud dalam profil produk.
Nama Medan Penerangan Guna
userGroupId

Pengecam kumpulan pengguna

Nilai Pemegang tempat boleh digunakan semasa cipta supaya objek lain boleh merujuk kumpulan pengguna baharu.

Boleh ditetapkan kepada nilai sementara apabila operation=create
userGroupName Nama kumpulan pengguna Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
userGroupDescription Perihalan teks kumpulan pengguna
userCount Bilangan pengguna dalam kumpulan pengguna Baca sahaja
profil

Tatasusunan id profil produk yang dikaitkan dengan kumpulan pengguna.

XLSX mempunyai satu baris bagi setiap nilai dengan nilai yang sama untuk medan lain.

Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
orgId Organisasi yang mengandungi kumpulan pengguna Digunakan sebagai rujukan untuk mencari objek yang mengandungi atau yang dikaitkan dengannya.
operation Salah satu daripada kosong, Cipta, Kemas Kini atau Padam. Tindakan yang perlu diambil apabila data diimport.  

Keperluan import:

  • orgId mesti merujuk kepada organisasi sedia ada atau organisasi yang sedang dicipta dalam import yang sama.
  • userGroupId mesti merujuk kepada kumpulan sedia ada untuk kemas kini atau padam, dan boleh menjadi id yang anda tentukan untuk kumpulan pengguna baharu.
  • Untuk kemas kini atau cipta, userGroupNameorganization tidak boleh kosong dan tidak boleh menduplikasi nama kumpulan pengguna atau profil produk lain dalam organisasi yang sama.
  • Pastikan userGroupName tidak duplikat dalam fail input dan organisasi.
  • userGroups yang akan dikemas kini atau dipadamkan mesti wujud dalam organisasi.
  • Profil yang akan dialihkan daripada kumpulan pengguna mesti wujud dalam kumpulan pengguna tersebut. Operasi kemas kini tidak boleh dilakukan pada profil kumpulan pengguna.
  • Untuk kumpulan pengguna yang akan dicipta, pastikan perkara berikut:
    • OrgId sepatutnya organisasi baharu atau organisasi sedia ada.
    • LicenseId, jika berkenaan, sepatutnya produk baharu atau produk sedia ada.
    • ProductProfileId sepatutnya profil produk baharu atau profil produk sedia ada.

Maklumat domain menyediakan maklumat yang hanya boleh dibaca tentang domain yang tersedia dalam setiap organisasi.Data ini tidak boleh diedit.

Nama Medan

Penerangan

Guna

orgId

Rujukan kepada organisasi di mana domain ini disenaraikan

Digunakan sebagai rujukan untuk mencari objek yang mengandungi atau berkaitan.

domainName

Nama domain, contohnya, adobe.com.

Baca sahaja

directoryName

Nama direktori tempat domain disenaraikan

Baca sahaja

directoryType

Salah satu daripada Federated ID atau Enterprise ID.

Baca sahaja

domainStatus

Salah satu daripada "ACTIVE", "RESERVED", "UNCLAIMED", "CLAIMED", "VALIDATED", "WITHDRAWN", "ACTIVE", "EXPIRED".

Baca sahaja

Dalam fail XLSX, terdapat dua helaian - satu untuk produk dan satu untuk sumber.Dalam JSON, objek sumber disusun dalam objek produk.

Produk:

Nama Medan Penerangan Gunakan
licenseId

id yang mengenal pasti produk.Setiap produk mempunyai id lesen unik dalam organisasi di mana ia disenaraikan. 

Id lesen untuk produk yang sama akan berbeza dalam organisasi yang berbeza.Apabila menambah produk baharu ini boleh kosong atau menggunakan pengecam pemegang tempat, contohnya, new_product_1.Pengecam pemegang tempat digunakan dalam kes di mana entri import lain perlu merujuk kepada contoh produk ini.Selepas penciptaan, id lesen sebenar ditugaskan yang menggantikan semua penggunaan id lesen Pemegang tempat.

Boleh ditetapkan kepada nilai sementara apabila operation=create
productName Nama produk Baca sahaja
productDescription Penerangan teks produk Baca sahaja
allowOverallocation

Boolean yang menunjukkan sama ada peruntukan berlebihan bagi instans produk ini dibenarkan.

Peruntukan berlebihan merujuk kepada keupayaan untuk memberikan lebih kuantiti kepada organisasi anak berbanding yang telah diberikan kepada anda.

Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
ikon URL ikon produk Baca sahaja
sourceLicenseId ID lesen tika produk dalam organisasi dari mana produk ini diperuntukkan.Nilai adalah null jika tika ini bukan produk yang diperuntukkan, sebaliknya adalah produk yang dibeli. Boleh ditetapkan apabila operation=Create
productId Pengecam produk. Baca sahaja
orgId Pengecam organisasi yang mengandungi instans produk ini Digunakan sebagai rujukan untuk mencari objek yang mengandungi atau berkaitan.
redistributable Boolean yang menunjukkan sama ada produk ini mempunyai sumber yang boleh diberikan kepada organisasi anak. Baca sahaja
resources objek yang mengandungi set objek sumber yang mewakili sumber dan tetapan dalam produk ini  
operation Salah satu daripada kosong, Create, Update atau Delete.Tindakan yang perlu diambil apabila data diimport.  

Keperluan import:

  • Untuk mencipta, licenseId mesti merupakan id unik yang anda cipta. 
  • Untuk mengemaskini, licenseId mesti merupakan id produk sedia ada dalam organisasi yang dinyatakan.
  • orgId mesti merujuk kepada organisasi sedia ada atau organisasi yang sedang dicipta dalam operasi import yang sama.
  • Untuk mencipta, sourceLicenseId mesti merujuk kepada produk sedia ada atau id yang anda tentukan untuk produk yang sedang dicipta dalam operasi import yang sama.
  • licenseId dan sourceLicenseId tidak boleh sama untuk produk dengan operasi Create.
  • Mengesahkan organisasi produk, organisasi tersebut mestilah organisasi baharu atau sudah wujud dalam hierarki organisasi.
  • Untuk operasi Update dan Delete , produk mestilah sudah wujud dalam hierarki organisasi.
  • licenseId yang ditandakan sebagai Delete tidak boleh digunakan sebagai sourceLicenseId produk dengan operasi Create dan Update .
  • Untuk produk dengan operasi Create , mengesahkan bahawa sourceLicenseId mestilah wujud dalam organisasi induk.

Sumber untuk produk:

Objek sumber boleh muncul dalam produk dan dalam profil produk.

Nama Medan Penerangan Guna
resourceName Nama sumber Baca sahaja
resourceId Pengecam sumber Baca sahaja
resourceDescription Penerangan teks tentang sumber Baca sahaja
icon URL ke imej untuk sumber Baca sahaja
productName Nama produk yang mana sumber ini adalah sebahagian daripadanya. Baca sahaja
licenseId Id lesen (contoh produk) bagi produk yang mana sumber ini adalah sebahagian daripadanya. Digunakan sebagai rujukan untuk mencari objek yang mengandungi atau berkaitan.
grantedQuantity Kuantiti yang diberikan bagi sumber ini: jumlah sumber yang ada untuk organisasi ini gunakan secara tempatan atau peruntukkan kepada organisasi anak. Boleh ditetapkan atau dikemas kini apabila operation=create atau operation=update, masing-masing
unit Nama unit bagi kuantiti geran. Baca sahaja
currentQuantity Kuantiti semasa yang boleh digunakan dalam organisasi ini. Ini adalah grantedQuantity tolak sumber yang diperuntukkan kepada organisasi anak. Ini adalah nilai yang dipaparkan dalam Admin Console untuk produk/sumber ini. Baca sahaja
provisionedQuantity Kuantiti yang sebenarnya disediakan: boleh kurang daripada geran atau semasa, boleh kurang daripada currentQuantity jika terdapat had tertentu. Baca sahaja
operation Salah satu daripada kosong, Cipta, Kemas Kini atau Padam.Tindakan yang perlu diambil apabila data diimport.  

Keperluan import:

Medan operation pada sumber diabaikan apabila produk yang mana ia dimiliki mempunyai operasi yang ditetapkan sebagai DELETE atau Create.

  • Tiada sumber harus ditandakan untuk pemadaman, ia adalah operasi yang tidak sah.
  • Untuk produk yang akan dicipta, bilangan sumber harus sepadan dengan bilangan sumber produk asal.
  • Untuk sumber dengan operasi Kemas Kini, sumber mesti wujud dalam produk.

Import dan eksport data peruntukan produk

Sebagai Pentadbir Global, anda boleh mengeksport data peruntukan produk sebagai fail JSON atau CSV. Anda kemudian boleh mengolah data ini dan muat naik semula data ini untuk mengimport perubahan. Apabila data yang berpotensi diubah suai dimuat naik, data baharu dibandingkan dengan data semasa dan sebarang perubahan digunakan pada data peruntukan produk.Anda kemudian boleh menyemak dan mengemukakan perubahan tertangguh supaya ia berkuat kuasa.

Eksport model peruntukan produk

Untuk mengeksport model peruntukan produk, lakukan yang berikut:

  1. Log masuk ke Global Admin Console dan pergi ke tab Peruntukan Produk .
  2. Pilih Pilihan Lain ikon dan pilih Eksport CSV atau Eksport JSON.Fail anda dimuat turun. Ketahui lebih lanjut mengenai format eksport.

Import model peruntukan produk

Anda boleh mengeksport data, mengubah suainya, dan kemudian mengimport fail yang diubah suai. Untuk mengimport model peruntukan produk, lakukan yang berikut:

  1. Log masuk ke Global Admin Console dan pergi ke tab Peruntukan Produk.
  2. Pilih ikon Pilihan Lain dan pilih Import.
  3. Pilih fail JSON atau CSV untuk dimuat naik.
  4. Pilih Semak Perubahan Belum Selesai. Selepas menyemak, pilih Hantar Perubahan untuk melaksanakannya.

Format eksport dan import untuk peruntukan produk

Format eksport dan import adalah sama.Semasa mengimport dalam format CSV, medan boleh muncul dalam mana-mana susunan tetapi mesti sentiasa padanan dengan baris pengepala mereka. Semasa mengimport dalam format JSON, medan boleh muncul dalam mana-mana susunan.

Anda mesti nyatakan operasi semasa mengimport data peruntukan produk. Operasi boleh menjadi salah satu daripada yang berikut:

  • Kemas Kini: menunjukkan suntingan (perubahan kepada nilai grantedQuantity, allowOverAllocation).
  • Cipta: menunjukkan untuk menambah sumber produk kepada organisasi yang dinyatakan.
  • Padam: menunjukkan pemadaman produk.

Jika tiada operasi diberikan, maka tiada perubahan berlaku apabila data diimport untuk baris tersebut dalam CSV atau objek dalam JSON.

Dalam fail yang dieksport, terdapat satu baris atau rekod untuk setiap sumber produk. Sesetengah produk mempunyai lebih daripada satu sumber.

Jika produk mempunyai lebih daripada satu sumber, operasi Kemas Kini boleh digunakan pada sumber bebas, operasi Padam memadamkan produk termasuk semua sumber daripada organisasi, dan operasi Cipta memerlukan rekod untuk setiap sumber dalam fail import supaya kuantiti yang betul bagi setiap sumber boleh dinyatakan. Medan allowOverAllocation adalah luas produk dan tidak kira sumber mana satu kemas kini kepada medan ini berada.

Nama Medan Penerangan Gunakan
productName Nama produk. Baca sahaja
licenseId

Id produk (unik kepada produk dalam organisasi).

Apabila menambah produk baharu, ini boleh kosong atau ditetapkan kepada pengecam pemegang tempat, contohnya, new_product_1.Pengecam pemegang tempat digunakan dalam kes di mana entri yang diimport lain perlu merujuk kepada produk ini.Selepas dicipta, id lesen sebenar akan ditetapkan dan menggantikan semua penggunaan id lesen pemegang tempat.

Boleh ditetapkan apabila operation=Create
sourceLicenseId Id produk induk. Ia kosong atau null jika ini mewakili pembelian dan bukannya peruntukan. Boleh ditetapkan apabila operation=Create
productId Id yang mengenal pasti kelas produk ini. Id ini dikongsi antara produk jenis yang sama dan berbeza daripada licenseId yang mengenal pasti contoh produk ini. Baca sahaja
resourceName Nama sumber produk ini. Contohnya, Lesen Pengguna. Baca sahaja
resourceId Id yang mengenal pasti sumber produk ini. Boleh ditetapkan apabila operation=Create
orgPathName Nama laluan organisasi yang mengandungi sumber produk ini. Segmen dipisahkan dengan "/". Baca sahaja
orgName Nama mudah organisasi yang mengandungi sumber produk ini. Ini ialah segmen akhir orgPathName. Baca sahaja
orgId ID organisasi bagi organisasi yang mengandungi sumber produk ini. Boleh ditetapkan apabila operation=Create
grantedQuantity

Bilangan unit kuantiti sumber yang diberikan kepada organisasi ini oleh induknya atau jumlah yang dibeli jika entri sumber produk ini mewakili pembelian.

Medan ini boleh dikemas kini kecuali untuk produk yang dibeli atau peruntukan akar yang pentadbir global tidak mempunyai kebenaran untuk mengubah.

Boleh dikemas kini apabila operation=Update

atau

operation=Create

unit Nama unit sumber. Sebagai contoh, Pengguna. Baca sahaja
totalAllocations Jumlah geran kepada organisasi bawahan daripada organisasi ini untuk sumber produk ini.Nilai ini termasuk pemberian langsung kepada anak-anak segera ditambah dengan lebihan peruntukan daripada organisasi tersebut. Sebagai contoh, jika organisasi ini memberikan 10 kepada anak dan anak tersebut kemudian memperuntukkan 25 kepada anaknya, totalAllocations akan menjadi 25: 10 yang diberikan kepada anak ditambah dengan lebihan sebanyak 15 dalam anak tersebut. Baca sahaja
grantOverage Jumlah yang mana totalAllocations melebihi grantedQuantity. Jika totalAllocations tidak melebihi grantedQuantity, nilai ini adalah null atau sifar. Baca sahaja
localLicensedQuantity Jumlah sumber ini yang diberikan kepada organisasi ini yang tinggal untuk kegunaannya selepas kuantiti yang diperuntukkan kepada anak-anak ditolak. Ini adalah jumlah yang ditunjukkan sebagai tersedia dalam Admin Console. Nilai ini boleh menjadi sifar tetapi tidak pernah negatif walaupun organisasi ini telah memperuntukkan sumber secara berlebihan kepada anak-anaknya. Baca sahaja
localUsage Bilangan unit sumber yang digunakan dalam organisasi ini. Sebagai contoh, mewakilkan Lesen Pengguna kepada pengguna akan dikira sebagai 1 unit penggunaan. Baca sahaja
totalUsage Bilangan unit sumber yang digunakan oleh organisasi ini dan semua anak. Ini menunjukkan penggunaan sumber ini dalam bahagian hierarki organisasi yang berakar pada organisasi ini. Baca sahaja
gunaLebihan Jumlah penggunaan keseluruhan melebihi geran organisasi (organisasi dan anak telah menggunakan lebih banyak sumber daripada yang tersedia). Ini menunjukkan nilai bukan sifar apabila jumlahPenggunaan melebihi kuantitiDilesenkanTempatan, Baca sahaja
benarkanLebihPeruntukan Menunjukkan sama ada pengguna dibenarkan memberikan lebih banyak sumber kepada anak walaupun tiada lagi untuk diberikan (dibenarkan memberikan walaupun geran berlebihan) Nilai ini terpakai untuk semua sumber produk ini. Jika cubaan dibuat untuk mengemaskini benarkanLebihperuntukan untuk lebih daripada satu sumber produk yang sama kepada nilai yang berbeza, hasilnya adalah rawak.  Boleh dikemaskini apabila operation=Update
isPurchasedProduct benar jika produk adalah produk pembelian (tidak diperuntukkan oleh induk). Ini bersamaan dengan sourceLicenseId mempunyai nilai kosong. Baca sahaja
boleh diedar semula benar jika produk boleh diperuntukkan kepada anak, palsu bermakna produk hanya tersedia dalam organisasi di mana ia ditunjukkan dan sumber tidak boleh diperuntukkan kepada organisasi lain. Baca sahaja
operasi Salah satu daripada kosong, Cipta, Kemas Kini atau Padam. Tindakan yang perlu diambil apabila data diimport.  

Pengesahan data

  • Medan operasi mesti mempunyai operasi yang sah.
  • Data import produk mesti mempunyai sifat dan nilai untuk medan yang diperlukan.
  • Sifat data import produk mesti mempunyai jenis yang betul.
  • Medan dasar produk (overAllocation) tidak boleh disediakan untuk sumber yang berbeza.
  • Medan grantedQuantity:
    • Tidak boleh ditukar kepada tanpa had jika ia belum tanpa had.
    • Mestilah integer bukan negatif atau nilai rentetan tanpa had.

Pengesahan kebenaran/kebolehcapaian

  • Organisasi yang berkaitan dengan data import mesti wujud. Jika anda mengemas kini, pastikan produk dan sumber yang berkaitan dengan data import benar-benar wujud.

Tambah pengesahan produk

  • SourceLicenseId mesti wujud.
  • Organisasi yang berkaitan dengan produk baharu mesti wujud.
  • Produk yang sedang dicipta tidak boleh wujud (produk dengan licenseId yang sama).
  • Sumber yang berkaitan dengan produk yang sedang dicipta mesti mempunyai productId yang sepadan dengan produk tersebut.