Izvoz ali uvoz organizacijske strukture in dodelitev izdelkov

Zadnja posodobitev 17. jun. 2025

Spoznajte, kako lahko globalni skrbniki poenostavijo upravljanje organizacije in izdelkov s funkcijami izvoza in uvoza v Global Admin Console.

Odprite zavihek Organizations v Global Admin Console za izvoz ali uvoz organizacijske strukture in odprite zavihek Product Allocation za podatke o dodelitvah.Uporabite ikono Več možnosti za izbiro izvoza ali uvoza.

Izvoz organizacijske strukture

Kot globalni skrbnik lahko izvozite organizacijsko hierarhijo. Prenesete lahko predstavitev JSON, CSV ali XLSX celotne organizacijske hierarhije ali njenega dela. Te podatke lahko nato uporabite za analizo ali spremembe.

Izbrana oblika izvoza vpliva na strukturo izvoženih podatkov.

  • Oblika CSV omogoča izvoz samo ene vrste podatkov naenkrat. Pri izvozu profilov izdelkov v obliki CSV so profili in viri združeni v eno tabelo. Za profil izdelka obstaja več vnosov, eden za vsak vir.
  • Oblika XLSX povzroči, da se vsaka podrobnost organizacije prikaže na ločenem listu.
    Zapisi so povezani med različnimi vrstami objektov z referenčnim identifikatorjem. V nekaterih primerih je lahko za določen objekt več vrstic, na primer pri objektih virov, ko je s posameznim virom povezan nabor vrednosti.
  • Oblika JSON je najbolj prilagodljiva. Lahko izkoristi strukturne povezave med izvoženimi objekti. Na primer, izdelki v organizaciji se prikažejo neposredno v elementu organizacije. V vseh treh oblikah so izvožena enaka polja, vendar so nekatere vrednosti v obliki JSON odvečne.

Prijavite se v Global Admin Console. V zavihku Organizacije uporabite izbirnik organizacij za izbiro hierarhije organizacij, kjer želite izvesti izvoz. Podatki za vse organizacije v hierarhiji so izvoženi.

Izberite ikono Več možnosti in izberite Izvozi.

Dodaj organizacijo

V pogovornem oknu Izvozi izberite, kaj želite izvoziti, in format za izvoz podatkov.

Izvozi podatke organizacije

Izberite Izvozi. Ustvarjanje datoteke za izvoz lahko traja nekaj minut. Ko je postopek končan, za prenos poročila pojdite na Global Admin Console > Insights > Izvozi poročila. Več informacij o funkciji Izvozi poročila.

Opomba

Datoteke JSON so izvožene v formatu zip. Odprete jih lahko z orodjem zip ali z funkcijami zip operacijskega sistema.

Po prenosu datoteke lahko manipulirate s podatki in jih nato uvozite nazaj. Uvožene posodobitve se prikažejo v Global Admin Console, kot da bi podatke urejali ročno.

Uvozite strukturo organizacije

Kot globalni skrbnik, lahko uvozite morebitno spremenjene podatke. Ob nalaganju se novi podatki primerjajo s trenutnimi podatki in vse spremembe se uporabijo za hierarhijo organizacij. Vsi uvozni postopki se izvajajo na posodobljeni kopiji hierarhije organizacij. Če imate kakršne koli spremembe, ki čakajo na potrditev, se uvozne spremembe dodajo k spremembam, ki čakajo na potrditev v hierarhiji.

Prijavite se v Global Admin Console. V zavihku Organizacije uporabite izbirnik organizacije za izbiro hierarhije organizacije, kjer želite izvesti uvoz.

Izberite ikono Več možnosti in izberite Uvoz. Odvisno od velikosti in kompleksnosti datoteke za uvoz lahko obdelava traja od nekaj sekund do nekaj minut.

Izberite Izberite datoteko in izberite datoteko JSON, CSV ali XLSX za nalaganje. Pri CSV je mogoče uvoziti le en podatek organizacije naenkrat in ne podpira uvoza izdelkov.

Uvožene spremembe se prikažejo, kot da ste podatke ročno uredili.

Izberite Zapri.

Izberite Preglejte čakajoče spremembe.Nato izberite Pošlji spremembe, da jih izvedete.

Pred izvajanjem sprememb se čakajoča dejanja prikažejo na enak način kot pri ročnem urejanju v Global Admin Console.

Sheme za izvoz in uvoz

Pri uvozu podatkov z datoteko CSV se lahko polja pojavijo v katerem koli vrstnem redu, vendar se morajo vedno ujemati z naslovno vrstico. 

Pri uvozu podatkov morate za vsak element določiti operacijo. Operacija je lahko katera koli od naslednjih:

  • Posodobi: označuje urejanje.
  • Ustvari: označuje ustvarjanje novega predmeta (na primer organizacije, skupine uporabnikov ali skrbnika).
  • Izbriši: označuje brisanje predmeta (na primer organizacije, skupine uporabnikov ali skrbnika).

Vnosni zapisi brez polja za operacijo ali s praznim poljem za operacijo so prezrti.

Ime polja Opis Opombe
id

ID organizacije

Pri dodajanju nove organizacije je lahko prazen ali nastavljen na nadomestni identifikator, na primer new_org_1. Nadomestni identifikator se uporabi v primerih, kjer se morajo drugi uvoženi vnosi sklicevati na to organizacijo. Po ustvarjanju bo dodeljen dejanski identifikator organizacije in zamenjal vso uporabo nadomestnega identifikatorja organizacije.

Lahko je nastavljeno na začasno vrednost, ko je operation=create
ime Preprosto ime organizacije. Najmanj 4, največ 100. Imena lahko vsebujejo znake UTF-8 do 3 bajtov, 4-bajtni znaki niso podprti.
Lahko je nastavljeno ali posodobljeno, ko je operation=create ali operation=update
countryCode Koda države ali regije Mora biti nastavljeno, ko je operation=create, lahko je posodobljeno, ko je operation=Update
tip Tip organizacije Samo za branje
parentOrgId

ID nadrejene organizacije. Prazno za korensko organizacijo.

Pri posodabljanju veljajo pomembne omejitve, vključno s tem, da mora biti novi nadrejeni element v isti hierarhiji in imeti izdelke, ki so prisotni v organizaciji.

Lahko je nastavljeno ali posodobljeno, ko je operation=create ali operation=update
adminCount Število skrbnikov Samo za branje
domainCount Število domen Samo za branje
userCount Število uporabnikov Samo za branje
userGroupCount Število uporabniških skupin Samo za branje
skrbniki Nabor skrbniških objektov, ki predstavljajo skrbnike za to organizacijo
Lahko manjka, če ni izbran za izvoz. Prikaže se v ločenem zavihku v datotekah XLSX.
domene Nabor predmetov domen, ki predstavljajo domene v tej organizaciji
izdelki Nabor predmetov izdelkov, ki predstavljajo izdelke v tej organizaciji
profili izdelkov Nabor predmetov profilov izdelkov, ki predstavljajo profile izdelkov v tej organizaciji
uporabniške skupine Nabor predmetov uporabniških skupin, ki predstavljajo uporabniške skupine v tej organizaciji
orgPolicies Struktura, ki predstavlja pravilnike in njihove vrednosti
operation Ena od možnosti: prazno, ustvari, posodobi ali izbriši.Dejanje, ki se izvede, ko se podatki uvozijo. Vedno prazno pri izvozu.

 

Zahteve za uvoz:

  • Za posodobitev ali brisanje mora orgId sklicevati na obstoječo organizacijo v vaši hierarhiji.
  • Če ustvarjate novo organizacijo, lahko polje orgId pustite prazno ali ga nastavite na edinstveni id, ki si ga lahko izmislite, na primer new-1 ali new-2. To zagotavlja id, ki se lahko uporabi za sklicevanje na organizacijo, ki bo ustvarjena.
  • Koda države mora biti veljavna.
  • orgId za operacijo Posodobi in Izbriši mora že biti prisoten v hierarhiji organizacije.
  • orgId, označen kot Delete , ne sme biti izbran kot parentOrgId za organizacije z operacijo Update ali Create .
  • Podrejene organizacije na isti ravni in z istim nadrejenim ne smejo imeti enakih orgNames.
  • Za ustvarjanje organizacije ali posodabljanje imena organizacije se ime organizacije ne sme ujemati z imenom obstoječe podrejene organizacije istega nadrejenega.
Ime polja Opis Uporaba
orgId Sklicevanje na organizacijo, v kateri deluje skrbnik. Uporablja se kot referenca za iskanje vsebujočih ali povezanih objektov.
firstName

Ime skrbniškega uporabnika.

Ime in priimek za uporabnike Adobe ID se lahko nadomesti z uporabniško podano vrednostjo, ko uporabnik sprejme povabilo.

Lahko se nastavi ali posodobi, ko je operation=create oziroma operation=update
lastName Priimek skrbniškega uporabnika
e-pošta E-poštni naslov skrbniškega uporabnika. To je glavni ključ za uporabnika in mora biti edinstven.
countryCode Koda države ali regije, kjer uporabnik deluje. Velja le za vrste Federated in Enterprise ID.
userType Eden od »Adobe ID«, »Enterprise ID« ali »Federated ID«. Samo za branje
adminType Eden od »GLOBAL ADMIN«, »GLOBAL VIEWER«, »SYSTEM ADMIN«, »USER GROUP ADMIN«, »PRODUCT ADMIN«, »PRODUCT PROFILE ADMIN«, »DEPLOYMENT ADMIN« in »STORAGE_ADMIN«. Lahko se nastavi, ko je operation=Create
groupId ID skupine, katere skrbnik je ta uporabnik. Pomembno samo za skrbnike uporabniških skupin in profilov izdelkov.
licenseId ID licence izdelka, za katerega je ta uporabnik skrbnik. Pomembno samo za skrbnike izdelkov.
v domeno Ime domene uporabnika, če se ne uporablja e-poštna domena
userName Uporabniško ime uporabnika, če se ne uporablja e-poštni naslov
operation Ena od možnosti: prazno, Ustvari, Posodobi ali Izbriši. Dejanje, ki se izvede ob uvozu podatkov.  

Zahteve za uvoz:

  • orgId, e-pošta, adminType in userType morajo vsebovati veljavne vrednosti.
  • countryCode mora biti veljaven.
  • Če uporabnik že obstaja in se posodablja, se mora userType ujemati z uporabnikom.
  • Preverite podvojene e-poštne naslove v organizaciji.

Izvoz in uvoz profilov izdelkov sestavljata dva dela: podrobnosti profila izdelka in nabor virov, povezanih s profilom izdelka. Ti viri identificirajo storitve, ki jih je mogoče konfigurirati, običajno le za omogočanje ali onemogočanje.

  • Objekti virov so ugnezdeni v profilu izdelka v obliki JSON.
  • Pri uporabi CSV ali XLSX s profili izdelkov so profili in viri združeni v eno tabelo. Za profil izdelka bo več vnosov, po en za vsak vir.
  • Polje »selected« v viru nadzoruje, ali je storitev omogočena.
  • Pri uvozu profilov izdelkov mora biti operacija ustvari ali posodobi na samem profilu izdelka in na vseh objektih virov, ki jih je treba posodobiti ali ustvariti.
Ime polja Opis Uporaba
productProfileId

Identifikator profila izdelka

Pri ustvarjanju je mogoče uporabiti nadomestno vrednost, da lahko drugi objekti sklicujejo na novi profil.

Lahko se nastavi na začasno vrednost, ko operation=create
productProfileName Ime profila izdelka. Ne more biti dvojnik drugih profilov izdelkov ali uporabniških skupin v isti organizaciji.
Lahko se nastavi ali posodobi, ko je operation=create ali operation=update
productProfileDescription Besedilni opis profila izdelka
licenseId Sklic ID-ja licence na izdelek Uporablja se kot sklic za iskanje vsebujočega ali povezanega predmeta
orgId Organizacija, ki vsebuje uporabniško skupino
obvestila Vrednost true ali false, ki označuje, ali naj se uporabnikom pošlje e-poštno obvestilo, ko so dodani ali odstranjeni iz tega profila izdelka Lahko se nastavi ali posodobi, ko je operation=create ali operation=update
resources

Niz virov, povezanih s tem profilom izdelka.

Polje virov je prisotno le za obliko JSON. Za obliki CSV in XLSX so viri predstavljeni z naslednjimi dodatnimi polji: resourceName, resourceId, resourceDescription, icon, selected, kvota, resourceType. Za podrobnosti o teh poljih glejte Izdelki in viri.

Če ima profil izdelka več kot en vir, bo prisotnih več vrstic, po eno za vsak vir. Ostala polja bodo imela enake vrednosti za vsak vir.

 
operation Eno od prazno, Ustvari, Posodobi ali Izbriši. Dejanje, ki ga je treba izvesti ob uvozu podatkov.  

Zahteve za uvoz:

  • productProfileId, licenseId in orgId morajo imeti veljavne vrednosti.
  • Pri ustvarjanju profila izdelka mora biti productProfileName veljavno ime in se ne sme podvojiti z drugim imenom profila izdelka ali uporabniške skupine v isti organizaciji.
  • Polje kvota mora imeti veljavno vrednost za vrsto enote. To je numerično ali »neomejeno«, kadar je resourceType=QUOTA, sicer prazno.
  • Polje obvestila mora biti true ali false.
  • Za uvoz CSV in XLSX preverite productProfileId, vsi vnosi morajo imeti isti orgId, licenseId in productProfileName.
  • Preverite podvojeni productProfileName v vhodni datoteki in organizaciji.
  • Profili za posodobitev in brisanje morajo biti prisotni v organizaciji.
  • Viri za posodobitev in brisanje (deaktivirani) morajo biti prisotni v profilu.
  • Za ustvarjanje profilov zagotovite naslednje:
    • orgId mora biti nova organizacija ali obstoječa organizacija.
    • LicenseId mora biti nov izdelek ali obstoječ izdelek.
    • Preverite vire za profil.

Viri v profilih izdelkov:

Ime polja Opis Uporaba
resourceName Ime vira Samo za branje
resourceId Identifikator vira Samo za branje
resourceDescription Besedilni opis vira Samo za branje
ikona URL do slike za vir Samo za branje
izbrano Za vnos konfiguracije, ali je funkcija omogočena. To polje je prisotno le v JSON.


Lahko se nastavi ali posodobi, ko je operation=create ali operation=update
kvota Količina glavnega vira, ki se lahko dodeli uporabnikom prek tega profila izdelka. To polje je prisotno le v JSON.
resourceType Če je prisotno, je vrednost SERVICE. Označuje, da ta vir predstavlja storitev, ki se lahko omogoči ali onemogoči glede na vrednost polja selected. To polje je prisotno le v JSON.
Samo za branje
operacija Eno od prazno, Create, Update ali Delete. Dejanje, ki se izvede, ko se podatki uvozijo.  

Zahteve za uvoz:

Polje za operacijo pri virih se prezre, ko imajo profili izdelkov, ki jim pripadajo, operacije nastavljene kot Delete ali Create.

  • Noben vir ne sme biti označen za brisanje, to je neveljavno dejanje.
  • Za profile izdelkov, ki se ustvarjajo, se mora število virov ujemati s številom virov izvornega profila izdelka.
  • Za vire z dejanjem Update mora biti vir prisoten v profilu izdelka.
Ime polja Opis Uporaba
userGroupId

Identifikator uporabniške skupine

Pri ustvarjanju se lahko uporabi nadomestna vrednost, tako da se lahko drugi objekti sklicujejo na novo uporabniško skupino.

Lahko se nastavi na začasno vrednost, ko je operation=create
userGroupName Ime uporabniške skupine Lahko se nastavi ali posodobi, ko je operation=create ali operation=update
userGroupDescription Besedilni opis uporabniške skupine
userCount Število uporabnikov v uporabniški skupini Samo za branje
profili

Niz identifikatorjev profilov izdelkov, s katerimi je povezana uporabniška skupina.

XLSX ima eno vrstico na vrednost z enakimi vrednostmi za druga polja.

Lahko se nastavi ali posodobi, ko je operation=create ali operation=update
orgId Organizacija, ki vsebuje uporabniško skupino Uporablja se kot referenca za iskanje vsebujočega ali povezanega predmeta.
operation Eno od: prazno, ustvari, posodobi ali izbriši.Dejanje, ki se izvede ob uvozu podatkov.  

Zahteve za uvoz:

  • orgId se mora sklicevati na obstoječo organizacijo ali organizacijo, ki se ustvarja v istem uvozu.
  • userGroupId se mora sklicevati na obstoječo skupino za posodobitev ali brisanje in je lahko identifikator, ki ga določite za nove uporabniške skupine.
  • Za posodobitev ali ustvarjanje userGroupNameorganization ne sme biti prazno in se ne sme podvajati z drugim imenom uporabniške skupine ali profila izdelka v isti organizaciji.
  • Poskrbite, da se userGroupName ne podvaja v vhodni datoteki in organizaciji.
  • Uporabniške skupine, ki jih je treba posodobiti ali izbrisati, morajo biti prisotne v organizaciji.
  • Profil, ki ga je treba odstraniti iz uporabniške skupine, mora biti prisoten v uporabniški skupini. Operacij posodobitve ni mogoče izvajati na profilu uporabniške skupine.
  • Za uporabniške skupine, ki jih je treba ustvariti, poskrbite za naslednje:
    • OrgId mora biti nova organizacija ali obstoječa organizacija.
    • LicenseId, če je ustrezen, mora biti nov izdelek ali obstoječ izdelek.
    • ProductProfileId mora biti nov profil izdelka ali obstoječ profil izdelka.

Informacije o domeni zagotavljajo podatke samo za branje o domenah, ki so na voljo v vsaki organizaciji.Teh podatkov ni mogoče urejati.

Ime polja

Opis

Uporaba

orgId

Sklic na organizacijo, v kateri je ta domena navedena

Uporabljen kot sklic za iskanje vsebujočih ali povezanih objektov.

domainName

Ime domene, na primer adobe.com.

Samo za branje

directoryName

Ime imenika, v katerem je domena navedena

Samo za branje

directoryType

Eden od Federated ID ali Enterprise ID.

Samo za branje

domainStatus

Eden od »ACTIVE«, »RESERVED«, »UNCLAIMED«, »CLAIMED«, »VALIDATED«, »WITHDRAWN«, »ACTIVE«, »EXPIRED«.

Samo za branje

V datotekah XLSX sta dve delovni tabeli – ena za izdelke in ena za vire. V JSON so objekti virov umeščeni v objekt izdelka.

Izdelki:

Ime polja Opis Uporaba
licenseId

identifikator, ki identificira izdelek. Vsak izdelek ima edinstveni ID licence v organizaciji, v kateri je naveden. 

ID licence za isti izdelek se razlikuje v različnih organizacijah. Pri dodajanju novega izdelka je lahko to prazno ali pa uporabite nadomestni identifikator, na primer new_product_1. Nadomestni identifikator se uporablja v primerih, ko se morajo drugi uvoženi vnosi sklicevati na to instanco izdelka. Po ustvarjanju se dodeli dejanski ID licence, ki nadomesti vso uporabo nadomestnega ID-ja licence.

Lahko se nastavi na začasno vrednost, ko je operation=create
productName Ime izdelka Samo za branje
productDescription Besedilni opis izdelka Samo za branje
allowOverallocation

Logična vrednost, ki označuje, ali je dovoljena prekomerna dodelitev te instance izdelka.

Prekomerna dodelitev se nanaša na zmožnost dodelitve večje količine podrejeni organizaciji, kot vam je bila dodeljena.

Lahko se nastavi ali posodobi, ko je operation=create oziroma operation=update
ikona URL ikone izdelka Samo za branje
sourceLicenseId ID licence instance izdelka v organizaciji, iz katere je bil ta izdelek dodeljen. Vrednost je null, če ta instanca ni dodeljen izdelek, temveč kupljen izdelek. Lahko se nastavi, ko je operation=Create
productId Identifikator izdelka. Samo za branje
orgId Identifikator organizacije, ki vsebuje to instanco izdelka Se uporablja kot sklic za iskanje vsebujočega ali povezanega predmeta.
redistributable Logična vrednost, ki označuje, ali ima ta izdelek vire, ki jih je mogoče dodeliti podrejenim organizacijam. Samo za branje
resources objekt, ki vsebuje nabor objektov virov, ki predstavljajo vire in nastavitve v tem izdelku  
operacija Ena od vrednosti: prazno, ustvari, posodobi ali DELETE. Dejanje, ki se izvede ob uvozu podatkov.  

Zahteve za uvoz:

  • Za ustvarjanje mora biti licenseId edinstven ID, ki ga ustvarite. 
  • Za posodabljanje mora biti licenseId ID obstoječega izdelka v določeni organizaciji.
  • orgId se mora sklicevati na obstoječo organizacijo ali organizacijo, ki se ustvarja v isti operaciji uvoza.
  • Za ustvarjanje se mora sourceLicenseId sklicevati na obstoječi izdelek ali ID, ki ste ga opredelili za izdelek, ki se ustvarja v isti operaciji uvoza.
  • licenseId in sourceLicenseId ne smeta biti enaka za izdelke z operacijo Ustvari.
  • Preverjanje organizacij izdelkov – organizacija mora biti nova ali pa mora že obstajati v hierarhiji organizacije.
  • Za operaciji posodobi in DELETE mora izdelek že obstajati v hierarhiji organizacije.
  • licenseId, označen kot DELETE, se ne sme uporabiti kot sourceLicenseId izdelkov z operacijama ustvari in posodobi.
  • Za izdelke z operacijo ustvari se preverja, ali mora sourceLicenseId obstajati v nadrejeni organizaciji.

Viri za izdelke:

Objekti virov se lahko pojavijo v izdelkih in v profilih izdelkov.

Ime polja Opis Uporaba
resourceName Ime vira Samo za branje
identifikator vira Identifikator vira Samo za branje
opis vira Besedilni opis vira Samo za branje
ikona URL do slike za vir Samo za branje
ime izdelka Ime izdelka, ki mu pripada ta vir. Samo za branje
licenseId ID licence (instanca izdelka) izdelka, kateremu pripada ta vir. Uporablja se kot referenca za iskanje vsebujočega ali povezanega predmeta.
dodeljena količina Dodeljena količina tega vira: količina virov, ki jih ima ta organizacija na voljo za lokalno uporabo ali dodelitev podrejenim organizacijam. Se lahko nastavi ali posodobi, ko je operation=create oziroma operation=update
enota Ime enote količine dodelitve. Samo za branje
trenutna količina Trenutna uporabna količina v tej organizaciji. To je dodeljena količina zmanjšana za vire, dodeljene podrejenim organizacijam. To je vrednost, ki se prikaže v Admin Console za ta izdelek ali vir. Samo za branje
provisionedQuantity Dejansko zagotovljena količina: lahko je manjša od dovoljenja ali trenutne vrednosti, lahko je manjša od trenutne količine, če velja določena omejitev. Samo za branje
operacija Ena od možnosti: prazno, ustvari, posodobi ali izbriši.Dejanje, ki se izvede ob uvozu podatkov.  

Zahteve za uvoz:

Polje operacije v virih se prezre, ko imajo izdelki, ki jim pripadajo, operacije nastavljene kot Delete ali Create.

  • Noben vir ne sme biti označen za brisanje, ker je to neveljavna operacija.
  • Za ustvaritev izdelkov se mora število virov ujemati s številom virov izvornih izdelkov.
  • Za vire z operacijo Update mora biti vir prisoten v izdelku.

Uvoz in izvoz podatkov o dodelitvi izdelkov

Kot Global Administrator lahko izvozite podatke o dodelitvi izdelkov kot datoteko JSON ali CSV. Te podatke lahko nato obdelate in jih naložite nazaj, da uvozite spremembe. Ko so potencialno spremenjeni podatki naloženi, se novi podatki primerjajo s trenutnimi podatki in vse spremembe se uporabijo za podatke o dodelitvi izdelkov.Nato lahko pregledate in pošljete čakajoče spremembe, da stopijo v veljavo.

Izvoz modela za dodelitev izdelkov

Za izvoz modela za dodelitev izdelkov, naredite naslednje:

  1. Prijavite se v Global Admin Console in pojdite na zavihek Product Allocation.
  2. Izberite ikono Več možnosti in izberite Izvozi CSV ali Izvozi JSON.Datoteka je prenesena. Več informacij o oblikah izvoza.

Uvozite model dodeljevanja izdelkov

Podatke lahko izvozite, spremenite in nato uvozite spremenjeno datoteko. Za uvoz modela dodeljevanja izdelkov naredite naslednje:

  1. Prijavite se v Global Admin Console in pojdite na zavihek Dodeljevanje izdelkov.
  2. Izberite ikono Več možnosti in izberite Uvoz.
  3. Izberite datoteko JSON ali CSV za nalaganje.
  4. Izberite Pregled čakajočih sprememb. Po pregledu izberite Pošlji spremembe, da jih izvedete.

Obliki za izvoz in uvoz pri dodeljevanju izdelkov

Obliki za izvoz in uvoz sta enaki. Pri uvozu v obliki CSV se lahko polja pojavijo v poljubnem vrstnem redu, vendar se morajo vedno ujemati z vrstico z glavo. Pri uvozu v obliki JSON se lahko polja pojavijo v poljubnem vrstnem redu.

Pri uvozu podatkov o dodeljevanju izdelkov morate določiti operacijo. Operacija je lahko ena od naslednjih:

  • Posodobi: označuje urejanje (sprememba vrednosti grantedQuantity, allowOverAllocation).
  • Ustvari: označuje dodajanje vira izdelka določeni organizaciji.
  • Izbriši: označuje brisanje izdelka.

Če operacija ni podana, se pri uvozu podatkov za to vrstico v CSV ali objekt v JSON spremembe ne zgodijo.

V izvoženi datoteki je ena vrstica ali zapis za vsak vir izdelka. Nekateri izdelki imajo več kot en vir.

Če ima izdelek več kot en vir, se operacije Posodobi lahko uporabljajo za neodvisne vire, operacija Izbriši izbriše izdelek, vključno z vsemi viri iz organizacije, operacija Ustvari pa potrebuje zapis za vsak vir v datoteki za uvoz, da lahko določite pravo količino vsakega od njih. Polje allowOverAllocation je na ravni izdelka in ni pomembno, v katerem viru je posodobitev tega polja.

Ime polja Opis Uporaba
productName Ime izdelka. Samo za branje
licenseId

ID izdelka (edinstven za izdelek v organizaciji).

Ko dodajate nov izdelek, je lahko to prazno ali nastavljeno na nadomestni identifikator, na primer new_product_1. Nadomestni identifikator se uporablja v primerih, kjer se morajo drugi uvoženi vnosi sklicevati na ta izdelek. Po ustvaritvi bo dodeljen dejanski ID licence in nadomestil vse uporabe nadomestnega ID-ja licence.

Lahko se nastavi, ko je operation=Create
sourceLicenseId ID nadrejenega izdelka. Je prazen ali nič, če to predstavlja nakup namesto dodelitve. Lahko se nastavi, ko je operation=Create
productId ID, ki identificira ta razred izdelka. Ta ID je skupen med izdelki iste vrste in se razlikuje od licenseId, ki identificira primerek tega izdelka. Samo za branje
resourceName Ime tega vira izdelka. Na primer uporabniške licence. Samo za branje
resourceId ID, ki identificira ta vir izdelka. Lahko se nastavi, ko je operation=Create
orgPathName Pot organizacije, v kateri se nahaja ta izdelčni vir. Segmenti, ločeni z »/«. Samo za branje
orgName Preprosto ime organizacije, ki vsebuje ta izdelčni vir. To je zadnji segment orgPathName. Samo za branje
orgId ID organizacije, ki vsebuje ta izdelčni vir. Lahko nastavite, ko operation=Create
grantedQuantity

Število enot količine virov, dodeljenih tej organizaciji s strani nadrejene organizacije, ali kupljena količina, če ta vnos izdelčnega vira predstavlja nakup.

To polje je mogoče posodobiti, razen za kupljene izdelke ali osnovne dodelitve, za katere globalni skrbnik nima dovoljenja za spreminjanje.

Lahko se posodobi, ko je operation=Update

ali

operation=Create

enota Ime enote vira. Na primer, Uporabniki. Samo za branje
totalAllocations Vsota dodelitev podrejenim organizacijam iz te organizacije za ta izdelčni vir. Ta vrednost vključuje neposredne dodelitve neposrednim otrokom plus presežne dodelitve iz teh organizacij. Na primer, če je ta organizacija dodelila otroku 10 in je otrok nato dodelil svojemu otroku 25, bi totalAllocations znašal 25: 10 dodeljenih otroku plus presežek 15 v tem otroku. Samo za branje
grantOverage Znesek, za katerega totalAllocations presega grantedQuantity. Če totalAllocations ne presega grantedQuantity, je ta vrednost prazna ali enaka nič. Samo za branje
localLicensedQuantity Količina tega vira, dodeljena tej organizaciji, ki ji ostane za uporabo, potem ko se odšteje količina, dodeljena podrejenim. To je količina, prikazana kot na voljo v Admin Console. Ta vrednost je lahko nič, vendar nikoli negativna, tudi če je ta organizacija namenila preveč virov svojim podrejenim. Samo za branje
localUsage Število enot vira, uporabljenih v tej organizaciji. Na primer, delegiranje uporabniške licence uporabniku se šteje za 1 enoto uporabe. Samo za branje
totalUsage Število enot vira, ki jih uporabljata ta organizacija in vsi podrejeni. To prikazuje uporabo tega vira v delu organizacijske hierarhije, ki se začne s to organizacijo. Samo za branje
useOverage Količina skupne uporabe, ki presega dodelitev organizacije (organizacija in podrejeni so uporabili več vira, kot je na voljo). To prikazuje vrednost, ki ni nič, ko totalUsage presega localLicensedQuantity, Samo za branje
allowOverAllocation Označuje, ali je uporabniku dovoljeno dodeliti več virov podrejenim, čeprav ni več za dodelitev (dovoljeno dodeliti kljub preseganju dodelitve). Ta vrednost velja za vse vire tega izdelka.Če se poskuša posodobiti allowOverallocation za več kot en vir istega izdelka na različne vrednosti, je rezultat naključen.  Lahko se posodobi, ko operation=Update
isPurchasedProduct true, če je izdelek nakupljeni izdelek (ni dodeljen s strani nadrejenega). To je enako temu, da ima sourceLicenseId prazno vrednost. Samo za branje
redistributable true, če je mogoče izdelek dodeliti otrokom, false pomeni, da je izdelek na voljo samo v organizaciji, v kateri je prikazan, in virov ni mogoče dodeliti drugi organizaciji. Samo za branje
operacija Eno izmed prazno, Ustvari, Posodobi ali Izbriši. Dejanje, ki ga je treba izvesti, ko se podatki uvozijo.  

Preverjanje veljavnosti podatkov

  • Polje operacije mora imeti veljavno operacijo.
  • Uvozni podatki izdelka morajo imeti lastnosti in vrednosti za zahtevana polja.
  • Lastnosti uvoznih podatkov izdelka morajo biti pravilnega tipa.
  • Polje pravilnika izdelka (overAllocation) se ne sme zagotoviti za različne vire.
  • Polje grantedQuantity:
    • Se ne more spremeniti v neomejeno , če že ni neomejeno.
    • Mora biti nenegativno celo število ali nizovna vrednost neomejeno.

Preverjanje veljavnosti dovoljenj/dostopnosti

  • Organizacija, povezana z uvoznimi podatki, mora obstajati. Če posodabljate, se prepričajte, da izdelek in vir, povezana z uvoznimi podatki, dejansko obstajata.

Preverjanje veljavnosti dodajanja izdelka

  • SourceLicenseId mora obstajati.
  • Organizacija, povezana z novim izdelkom, mora obstajati.
  • Izdelek, ki se ustvarja, ne sme obstajati (izdelek z istim licenseId).
  • Viri, povezani z izdelkom, ki se ustvarja, morajo imeti ustrezen productId, ki se ujema s tem izdelkom.