Conectați-vă la Global Admin Console. În fila Organizații , utilizați selectorul de organizații pentru a selecta ierarhia organizației în care doriți să efectuați exportul. Datele pentru toate organizațiile din ierarhie sunt exportate.
Ultima actualizare la
17 iun. 2025
Aflați cum administratorii globali pot eficientiza gestionarea organizației și produselor cu funcțiile de export și import din Global Admin Console.
Accesați fila Organizations din Global Admin Console pentru a exporta sau importa structura organizației și mergeți la fila Product Allocation pentru datele de alocare.Utilizați pictograma More Options pentru a selecta exportul sau importul.
Exportați structura organizației
Ca administrator global, puteți exporta ierarhia organizației. Puteți descărca o reprezentare JSON, CSV sau XLSX a întregii ierarhii organizaționale sau a unei părți din aceasta. Apoi puteți folosi aceste date pentru a analiza sau a efectua modificări.
Formatul de export ales influențează structura datelor exportate.
- Formatul CSV permite exportarea unui singur tip de date deodată. La exportarea profilurilor de produs în format CSV, profilurile și resursele sunt combinate într-un singur tabel. Există mai multe intrări pentru profilul de produs, câte una pentru fiecare resursă.
- Formatul XLSX face ca fiecare detaliu al organizației să fie afișat într-o foaie separată.
Înregistrările sunt conectate între diferitele tipuri de obiecte printr-un id de referință. În unele cazuri, pot exista mai multe rânduri pentru un anumit obiect, cum ar fi în cazul obiectelor Resource când există un set de valori asociate cu o anumită resursă.
- Formatul JSON este cel mai flexibil. Poate profita de relațiile structurale dintre obiectele exportate. De exemplu, produsele dintr-o organizație apar direct în elementul organizație. Aceleași câmpuri sunt exportate în toate cele trei formate, dar unele valori sunt redundante în formatul JSON.
Selectați pictograma Mai multe opțiuni și alegeți Export.
În caseta de dialog Export , selectați ce să exportați și un format în care să exportați datele.
Selectați Export. Fișierul de export poate dura câteva minute pentru a fi generat. Odată finalizat, pentru a descărca raportul, navigați la Global Admin Console > Perspectivă > Rapoarte de export. Mai multe informații despre funcția Rapoarte de export.
Notă
Fișierele JSON sunt exportate în format zip. Le puteți deschide folosind un utilitar zip sau funcțiile zip ale sistemului de operare.
După descărcarea fișierului, puteți manipula datele și apoi le puteți importa înapoi. Actualizările importate apar în Global Admin Console ca și cum ați fi editat manual datele.
Importați structura organizației
Ca administrator global, puteți importa date potențial modificate. Când sunt încărcate, datele noi sunt comparate cu datele curente și orice modificări sunt aplicate ierarhiei organizației. Toate operațiunile de import sunt efectuate pe copia actualizată a ierarhiei organizației. Dacă aveți modificări în așteptare, modificările de import vor fi adăugate peste modificările în așteptare din ierarhie.
Conectați-vă la Global Admin Console. În fila Organizations , utilizați selectorul de organizații pentru a selecta ierarhia organizației unde doriți să efectuați importul.
Selectați pictograma More Options 
și selectați Import. În funcție de dimensiunea și complexitatea fișierului de import, procesarea poate dura de la câteva secunde la câteva minute.
Selectați Select a file și alegeți un fișier JSON, CSV sau XLSX pentru a fi încărcat.Pentru CSV, doar un singur detaliu de organizație poate fi importat la un moment dat și nu acceptă importarea produselor.
Modificările importate apar ca și cum ați fi editat manual datele.
Selectați Închidere.
Selectați Review Pending Changes. Apoi, selectați Submit Changes pentru a le executa.
Înainte de a executa modificările, acțiunile în așteptare sunt afișate în același mod ca atunci când editările sunt făcute manual în Global Admin Console.
Scheme de export și import
În timp ce importați date folosind un fișier CSV, câmpurile pot apărea în orice ordine, dar trebuie să se potrivească întotdeauna cu rândul lor antet.
În timpul importului de date, trebuie să specificați o operație pentru fiecare element. Operația poate fi oricare dintre următoarele:
- Update: indică o editare.
- Create: indică crearea unui obiect nou (De exemplu, organizație, grup de utilizatori sau administrator).
- Delete: indică ștergerea unui obiect (De exemplu, organizație, grup de utilizatori sau administrator).
Înregistrările de intrare fără câmp de operație sau cu câmp gol sunt ignorate.
| Câmp de nume | Descriere | Note |
|---|---|---|
| id | Id-ul Organizației. Când adăugați o nouă organizație, acest câmp poate fi gol sau setat la un identificator placeholder, de exemplu, new_org_1. Identificatorul placeholder este folosit în cazurile în care alte intrări importate trebuie să facă referire la această organizație. După crearea acesteia, un id actual de organizație va fi atribuit și va înlocui toate utilizările id-ului placeholder al organizației. |
Poate fi setat la o valoare temporară când operation=create |
| nume | Numele simplu al organizației. Lungime minimă 4, maximă 100.Numele pot conține caractere UTF-8 de până la 3 octeți, caracterele de 4 octeți nu sunt acceptate. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| countryCode | Codul țării sau regiunii | Trebuie setat când operation=create, poate fi actualizat când operation=Update |
| tip | Tipul organizației | Doar pentru citire |
| parentOrgId | ID-ul organizației părinte. Gol pentru organizația rădăcină. La actualizare, se aplică restricții semnificative, inclusiv că noul părinte să fie în aceeași ierarhie și să aibă produsele care sunt prezente în organizație. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| adminCount | Numărul de administratori | Doar pentru citire |
| domainCount | Numărul de domenii | Doar-pentru-citire |
| userCount | Număr de utilizatori | Doar pentru citire |
| userGroupCount | Numărul de grupuri de utilizatori | Doar-pentru-citire |
| administratori | Set de obiecte de administrare reprezentând administratorii pentru această organizație |
Poate lipsi dacă nu este selectat pentru export. Se afișează într-o filă separată în fișierele XLSX. |
| domenii | Set de obiecte de domeniu reprezentând domeniile din această organizație |
|
| produse | Set de obiecte produs reprezentând produsele din această organizație |
|
| productProfiles | Set de obiecte profil produs reprezentând profilurile de produs din această organizație |
|
| userGroups | Set de obiecte grup utilizatori reprezentând grupurile de utilizatori din această organizație |
|
| orgPolicies | Structură reprezentând politicile și valorile acestora | |
| operațiune | Una dintre gol, Create, Update sau Delete. Acțiunea de efectuat când datele sunt importate. | Întotdeauna gol la export. |
Cerințe de import:
- Pentru actualizare sau ștergere, orgId trebuie să se refere la o organizație existentă în ierarhia dvs.
- Dacă creați o organizație nouă, puteți lăsa câmpul orgId gol sau îl puteți seta la un id unic pe care îl puteți inventa, cum ar fi new-1 sau new-2. Aceasta oferă un id care poate fi folosit pentru a se referi la organizația care urmează să fie creată.
- Codul țării trebuie să fie valid.
- orgId pentru operațiunea Update și Delete trebuie să fie deja prezent în ierarhia organizației.
- orgId marcat ca Delete nu trebuie selectat ca parentOrgId pentru organizații cu operațiunea Update sau Create .
- Organizațiile copil de la același nivel și cu același părinte nu trebuie să aibă aceleași orgNames.
- Pentru crearea unei organizații sau actualizarea numelui unei organizații, numele organizației nu trebuie să se potrivească cu numele unui copil existent al aceluiași părinte.
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| orgId | Referință la organizația în care rezidă administratorul. | Folosit ca referință pentru găsirea obiectelor conținute sau asociate. |
| firstName | Prenumele utilizatorului administrator. Prenumele și numele de familie pentru utilizatorii Adobe ID pot fi înlocuite cu o Valoare furnizată de utilizator când utilizatorul acceptă invitația. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| lastName | Numele de familie al utilizatorului administrator | |
| Adresa de e-mail a utilizatorului administrator.Aceasta este o cheie principală pentru utilizator și trebuie să fie unică. | ||
| countryCode | Codul țării sau regiunii unde operează utilizatorul. Se aplică doar tipurilor Federated și Enterprise Id. |
|
| userType | Una din "Adobe ID", "Enterprise ID", sau "Federated ID". | Doar pentru citire |
| adminType | Una din "GLOBAL ADMIN", "GLOBAL VIEWER", "SYSTEM ADMIN", "USER GROUP ADMIN", "PRODUCT ADMIN", "PRODUCT PROFILE ADMIN", "DEPLOYMENT ADMIN", și "STORAGE_ADMIN". | Poate fi setat când operation=Create |
| groupId | ID-ul grupului pentru care acest utilizator este administrator.Relevant doar pentru administratorii de grupuri de utilizatori și administratorii de profiluri de produse. | |
| licenseId | ID-ul licenței de produs pentru produsul pentru care acest utilizator este administrator. Relevant doar pentru administratorii de produse. | |
| domeniu | Numele domeniului utilizatorului dacă nu se folosește domeniul de e-mail | |
| userName | Numele de utilizator al utilizatorului dacă nu se folosește adresa de e-mail | |
| operation | Una dintre opțiunile goale, Create, Update sau Delete. Acțiunea de efectuat când datele sunt importate. |
Cerințe pentru import:
- orgId, email, adminType și userType trebuie să conțină valori valide.
- countryCode trebuie să fie valid.
- Dacă utilizatorul există deja și este actualizat, userType trebuie să se potrivească cu utilizatorul.
- Verificați adresele de e-mail duplicate din organizație.
Exporturile și importurile profilurilor de produse constau din două părți: detaliile profilului de produs și un set de resurse asociate cu profilul de produs. Aceste resurse identifică serviciile care pot fi configurate, de obicei doar pentru a le activa sau dezactiva.
- Obiectele resursă sunt încorporate în profilul de produs în format JSON.
- Când folosiți CSV sau XLSX cu profiluri de produse, profilurile și resursele sunt combinate într-un singur tabel. Vor fi multiple intrări pentru profilul de produs, câte una pentru fiecare resursă.
- Câmpul „selected" din resursă controlează dacă serviciul este activat.
- Când importați profiluri de produse, trebuie să existe o operațiune Create sau Update pe profilul de produs în sine și pe orice obiecte resursă care urmează să fie actualizate sau create.
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| productProfileId | Identificatorul profilului de produs Valoarea de substituție poate fi folosită la creare pentru ca alte obiecte să poată face referire la noul profil. |
Poate fi setat la valoare temporară când operation=create |
| productProfileName | Numele profilului de produs. Nu poate fi un duplicat al altor profiluri de produs sau grupuri de utilizatori din aceeași organizație. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| productProfileDescription | Descrierea textuală a profilului de produs | |
| licenseId | Referința ID-ului de licență al produsului | Folosit ca referință pentru găsirea obiectului conținător sau asociat |
| orgId | Organizația care conține grupul de utilizatori | |
| notificări | Adevărat sau fals pentru a indica dacă notificarea prin email ar trebui trimisă utilizatorilor când sunt adăugați sau eliminați din acest profil de produs | Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| resurse | Matrice de resurse asociate cu acest profil de produs. Câmpul resources este prezent doar pentru formatul JSON. Pentru formatele CSV și XLSX, resursele sunt reprezentate cu următoarele câmpuri adiționale: resourceName, resourceId, resourceDescription, icon, selected, quota, resourceType. Pentru detalii despre aceste câmpuri, consultați Products and Resources. Dacă profilul de produs are mai mult de o resursă, vor fi prezente mai multe rânduri, unul pentru fiecare resursă. Celelalte câmpuri vor avea aceleași valori pentru fiecare resursă. |
|
| operation | Una dintre: gol, Create, Update sau Delete.Acțiunea de întreprins când datele sunt importate. |
Cerințe de import:
- productProfileId, licenseId și orgId trebuie să aibă valori valide.
- Când creați un profil de produs, productProfileName trebuie să fie un nume valid și nu trebuie să dubleze alt nume de profil de produs sau nume de grup de utilizatori din aceeași organizație.
- Câmpul cotă trebuie să aibă o valoare validă pentru tipul de unitate. Aceasta este numerică sau "nelimitată" când resourceType=QUOTA sau gol în caz contrar.
- Câmpul de notificare trebuie să fie true sau false.
- Pentru importuri CSV și XLSX, validați productProfileId, toate intrările sale trebuie să aibă același orgId, licenseId și productProfileName.
- Validați productProfileName duplicat în fișierul de intrare și organizație.
- Profilurile care urmează să fie actualizate și șterse trebuie să fie prezente în organizație.
- Resursele care urmează să fie actualizate și șterse (dezactivate) trebuie să fie prezente în profil.
- Pentru profilurile care urmează să fie create, asigurați-vă de următoarele:
- orgId ar trebui să fie o organizație nouă sau o organizație existentă.
- licenseId ar trebui să fie un produs nou sau un produs existent.
- Validați resursele pentru profil.
Resurse în profilurile de produs:
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| resourceName | Numele resursei | Doar-pentru-citire |
| resourceId | Identificatorul resursei | Doar-pentru-citire |
| resourceDescription | Descriere textuală a resursei | doar pentru citire |
| pictogramă | URL către imaginea pentru resursă | Doar pentru citire |
| selectat | Pentru o intrare de configurare, dacă funcția este activată. Acest câmp este prezent doar în JSON. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| cotă | Cantitatea de resurse principale care poate fi distribuită utilizatorilor prin acest profil de produs.Acest câmp este prezent doar în JSON. |
|
| resourceType | Dacă este prezent, valoarea este SERVICE. Indică faptul că această resursă reprezintă un serviciu care poate fi activat sau dezactivat pe baza valorii câmpului selectat.Acest câmp este prezent doar în JSON. |
Doar-pentru-citire |
| operațiune | Una dintre valorile blank, Create, Update sau Delete. Acțiunea de efectuat când datele sunt importate. |
Cerințe de import:
Câmpul Operation pentru resurse este ignorat când profilul de produs căruia îi aparțin are operațiunile setate ca Delete sau Create.
- Nicio resursă nu ar trebui marcată pentru ștergere, aceasta fiind o operațiune invalidă.
- Pentru profilurile de produse care urmează să fie create, numărul de resurse trebuie să corespundă cu numărul de resurse din profilul de produs sursă.
- Pentru resursele cu operațiunea Update , resursa trebuie să fie prezentă în profilul de produs.
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| userGroupId | Identificatorul grupului de utilizatori Valoarea placeholder poate fi folosită la creare astfel încât alte obiecte să poată referenția noul grup de utilizatori. |
Poate fi setat la o valoare temporară când operation=create |
| userGroupName | Numele grupului de utilizatori | Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| userGroupDescription | Descrierea text a grupului de utilizatori | |
| userCount | Numărul de utilizatori din grupul de utilizatori | Doar-pentru-citire |
| profiluri | Matrice de ID-uri de profil de produs cu care este asociat grupul de utilizatori. XLSX are un rând per valoare cu aceleași valori pentru alte câmpuri. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| orgId | Organizația care conține grupul de utilizatori | Utilizat ca referință pentru a găsi obiectul conținător sau asociat. |
| operation | Una dintre blank, Create, Update sau Delete. Acțiunea de efectuat când datele sunt importate. |
Cerințe de import:
- orgId trebuie să se refere la o organizație existentă sau la o organizație care este creată în același import.
- userGroupId trebuie să se refere la un grup existent pentru actualizare sau ștergere și poate fi un ID pe care îl definiți pentru grupuri de utilizatori noi.
- Pentru actualizare sau creare, userGroupNameorganization nu trebuie să fie gol și nu trebuie să dubleze numele altui grup de utilizatori sau profil de produs din aceeași organizație.
- Asigurați-vă că userGroupName nu este duplicat în fișierul de intrare și organizația.
- userGroups care urmează să fie actualizate sau șterse trebuie să fie prezente în organizație.
- Profilul care urmează să fie eliminat din grupul de utilizatori trebuie să fie prezent în grupul de utilizatori. Operațiunile de actualizare nu pot fi efectuate pe profilul unui grup de utilizatori.
- Pentru grupurile de utilizatori care urmează să fie create, asigurați-vă de următoarele:
- OrgId trebuie să fie o organizație nouă sau o organizație existentă.
- LicenseId, dacă este cazul, trebuie să fie un produs nou sau un produs existent.
- ProductProfileId trebuie să fie un profil de produs nou sau un profil de produs existent.
Informațiile despre domeniu oferă informații numai pentru citire despre domeniile disponibile în fiecare organizație.Aceste date nu sunt editabile.
|
Câmp de nume |
Descriere |
Utilizare |
|---|---|---|
|
orgId |
Referință la organizația în care este listat acest domeniu |
Utilizat ca referință pentru a găsi obiecte conținute sau asociate. |
|
domainName |
Numele domeniului, de exemplu, adobe.com. |
Doar pentru citire |
|
directoryName |
Numele directorului în care este listat domeniul |
Doar pentru citire |
|
directoryType |
Unul dintre Federated ID sau Enterprise ID. |
Doar pentru citire |
|
domainStatus |
Unul dintre "ACTIV", "REZERVAT", "NEREVENDICAT", "REVENDICAT", "VALIDAT", "RETRAS", "ACTIV", "EXPIRAT". |
Doar pentru citire |
În fișierele XLSX, există două foi - una pentru produse și una pentru resurse. În JSON, obiectele resursă sunt înglobate în obiectul produs.
Produse:
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| licenseId | id care identifică produsul. Fiecare produs are un id de licență unic în organizația în care este enumerat. Id-ul de licență pentru același produs va fi diferit în diferite organizații. Când se adaugă un produs nou, acest câmp poate fi gol sau poate utiliza un identificator substituent, de exemplu, new_product_1. Identificatorul substituent este utilizat în cazurile în care alte intrări importate trebuie să facă referire la această instanță de produs. După creare, este atribuit un ID de licență real care înlocuiește toate utilizările ID-ului de licență placeholder. |
Poate fi setat la o Valoare temporară când operation=create |
| productName | Numele produsului | Doar pentru citire |
| productDescription | Descrierea text a produsului | Doar pentru citire |
| allowOverallocation | Boolean care indică dacă supraalocarea acestei instanțe de produs este permisă. Supraalocarea se referă la capacitatea de a acorda mai multă cantitate unei organizații copil decât ați primit. |
Poate fi setat sau actualizat când operation=create sau operation=update, respectiv |
| pictogramă | URL-ul pictogramei produsului | Doar pentru citire |
| sourceLicenseId | Id-ul de licență al instanței de produs din organizația din care a fost alocat acest produs. Valoarea este null dacă această instanță nu este un produs alocat, ci este un produs cumpărat. | Poate fi setat când operation=Create |
| productId | Identificatorul produsului. | Doar pentru citire |
| orgId | Identificatorul organizației care conține această instanță de produs | Utilizat ca referință pentru a găsi obiectul care îl conține sau cu care este asociat. |
| redistributable | Boolean care indică dacă acest produs are resurse care pot fi acordate organizațiilor copil. | Doar-pentru-citire |
| resources | obiect care conține un set de obiecte de resurse reprezentând resursele și setările din acest produs | |
| operațiune | Una dintre blank, Create, Update sau Delete. Acțiunea de efectuat când datele sunt importate. |
Cerințe de import:
- Pentru create, licenseId trebuie să fie un id unic pe care îl creați.
- Pentru update, licenseId trebuie să fie id-ul unui produs existent în organizația specificată.
- orgId trebuie să se refere la o organizație existentă sau la una care este creată în aceeași operațiune de import.
- Pentru operațiunea de creare, sourceLicenseId trebuie să se refere la un produs existent sau la ID-ul pe care l-ați definit pentru un produs care este creat în aceeași operațiune de import.
- licenseId și sourceLicenseId nu ar trebui să fie identice pentru produsele cu operațiunea Create.
- Validați organizațiile produselor, organizația ar trebui să fie una nouă sau ar trebui să fie deja prezentă în ierarhia organizației.
- Pentru operațiunea Update și Delete , produsul ar trebui să fie deja prezent în ierarhia organizației.
- licenseId marcat ca Delete nu ar trebui să fie utilizat ca sourceLicenseId pentru produse cu operațiunile Create și Update .
- Pentru produsele cu operațiunea Create , se validează că sourceLicenseId trebuie să fie prezent în organizația părinte.
Resurse pentru produse:
Obiectele resurse pot apărea în produse și în profilurile de produse.
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| resourceName | Numele resursei | Doar pentru citire |
| resourceId | Identificatorul resursei | Doar-pentru-citire |
| resourceDescription | Descrierea text a resursei | Doar pentru citire |
| pictogramă | URL către imaginea pentru resursă | Doar pentru citire |
| productName | Numele produsului din care face parte această resursă. | Doar pentru citire |
| licenseId | ID-ul licenței (instanța produsului) a produsului din care face parte această resursă. | Utilizat ca referință pentru a găsi obiectul care conține sau este asociat. |
| grantedQuantity | Cantitatea acordată din această resursă: cantitatea de resurse pe care această organizație o are disponibilă pentru utilizare locală sau pentru alocare către organizațiile copil. | Poate fi setată sau actualizată când operation=create sau operation=update, respectiv |
| unit | Numele unității de măsură a cantității acordate. | Doar-pentru-citire |
| currentQuantity | Cantitatea utilizabilă curentă în această organizație. Aceasta este cantitatea acordată (grantedQuantity) minus resursele alocate organizațiilor copil.Aceasta este valoarea care este afișată în Admin Console pentru acest produs/resursă. | Doar pentru citire |
| provisionedQuantity | Cantitatea aprovizionată efectiv: poate fi mai mică decât acordarea sau cea curentă, poate fi mai mică decât currentQuantity dacă este în vigoare o anumită limitare. | Doar pentru citire |
| operațiune | Una dintre gol, Create, Update sau Delete. Acțiunea de efectuat când datele sunt importate. |
Cerințe de import:
Câmpul Operațiune de pe resurse este ignorat când produsul căruia îi aparțin are operațiunile setate ca Delete sau Create.
- Nicio resursă nu ar trebui să fie marcată pentru ștergere, este o operațiune invalidă.
- Pentru ca produsele să fie create, numărul de resurse trebuie să corespundă cu numărul de resurse al produselor sursă.
- Pentru resursele cu operațiunea Update , resursa trebuie să fie prezentă în produs.
Importați și exportați datele de alocare a produselor
Ca Administrator global, puteți exporta datele de alocare a produsului ca fișier JSON sau CSV. Puteți apoi să manipulați aceste date și să le încărcați înapoi pentru a importa modificările. Când datele potențial modificate sunt încărcate, datele noi sunt comparate cu datele curente și orice modificări sunt aplicate la datele de alocare a produsului. Puteți apoi să examinați și să trimiteți modificările în așteptare pentru ca acestea să intre în vigoare.
Exportați modelul de alocare a produsului
Pentru a exporta modelul de alocare a produsului, procedați după cum urmează:
- Conectați-vă la Global Admin Console și navigați la fila Alocare produs.
- Selectați pictograma Mai multe opțiuni și selectați Export CSV sau Export JSON. Fișierul dvs. este descărcat. Mai multe informații despre formatele de export.
Importați modelul de alocare a produsului
Puteți să exportați datele, să le modificați și apoi să importați fișierul modificat. Pentru a importa modelul de alocare a produsului, procedați astfel:
- Conectați-vă la Global Admin Console și navigați la fila Product Allocation.
- Selectați pictograma Mai multe opțiuni și selectați Importare.
- Selectați un fișier JSON sau CSV pentru încărcare.
- Selectați Examinați modificările în așteptare. După examinare, selectați Trimiteți modificările pentru a le executa.
Formate de export și import pentru alocarea produselor
Formatele de export și import sunt aceleași. La importarea în format CSV, câmpurile pot să apară în orice ordine, dar trebuie să se potrivească întotdeauna cu rândul lor de antet. La importarea în format JSON, câmpurile pot să apară în orice ordine.
Trebuie să specificați operația în timpul importării datelor de alocare a produsului. Operația poate fi una dintre următoarele:
- Actualizare: indică o editare (modificare a valorilor grantedQuantity, allowOverAllocation).
- Creare: indică să adăugați o resursă de produs la organizația specificată.
- Delete: indică ștergerea produsului.
Dacă nu este specificată nicio operație, atunci nu se produc modificări când datele sunt importate pentru acel rând în CSV sau obiect în JSON.
În fișierul exportat, există un rând sau înregistrare pentru fiecare resursă de produs. Unele produse au mai mult de o resursă.
Dacă un produs are mai mult de o resursă, operațiile de actualizare se pot aplica la resurse independente, o operațiune de ștergere șterge produsul incluzând toate resursele dintr-o organizație, iar o operațiune de creare necesită o înregistrare pentru fiecare dintre resursele din fișierul de import pentru a putea specifica cantitatea corespunzătoare a fiecăreia dintre ele.Câmpul allowOverAllocation este la nivel de produs și nu contează în care resursă se află o actualizare a acestui câmp.
| Câmp de nume | Descriere | Utilizare |
|---|---|---|
| productName | Numele produsului. | Doar pentru citire |
| licenseId | ID-ul unui produs (unic pentru un produs într-o organizație). Când adăugați un produs nou, acesta poate fi gol sau setat la un identificator rezervat, de exemplu, new_product_1. Identificatorul rezervat este utilizat în cazurile în care alte intrări importate trebuie să facă referire la acest produs. După creare, va fi atribuit un id de licență real și va înlocui toate utilizările id-ului de licență rezervat. |
Poate fi setat când operation=Create |
| sourceLicenseId | Id-ul produsului părinte. Este gol sau null dacă aceasta reprezintă o achiziție în loc de o alocare. | Poate fi setat când operation=Create |
| productId | Id care identifică această clasă de produs. Acest id este partajat între produsele de același tip și diferă de licenseId care identifică o instanță a acestui produs. | Doar pentru citire |
| resourceName | Numele acestei resurse de produs. De exemplu, licențe de utilizator. | Doar pentru citire |
| resourceId | Id care identifică această resursă de produs. | Poate fi setat când operation=Create |
| orgPathName | Numele de cale al organizației în care se află această resursă de produs. Segmente separate prin "/". | Doar-pentru-citire |
| orgName | Numele simplu al organizației care conține această resursă de produs. Acesta este segmentul final al orgPathName. | Doar pentru citire |
| orgId | Id-ul organizației care conține această resursă de produs. | Poate fi setat când operațiunea=Creare |
| grantedQuantity | Numărul de unități de cantitate de resurse acordate acestei organizații de către părintele său sau suma cumpărată dacă această intrare de resurse de produs reprezintă o achiziție. Acest câmp poate fi actualizat cu excepția produselor achiziționate sau alocărilor rădăcină pentru care administratorul global nu are permisiunea să facă modificări. |
Poate fi actualizat când operation=Update sau operațiunea=Creare |
| unit | Numele unității de resursă. De exemplu, Utilizatori. | Doar pentru citire |
| totalAllocations | Suma granturilor către organizațiile copil din această organizație pentru această resursă de produs. Această Valoare include granturile directe către copiii imediați plus supraalocările din acele organizații. De exemplu, dacă această organizație a acordat unui copil 10 și copilul apoi și-a alocat copilul 25, totalAllocations ar fi 25: cele 10 acordate copilului plus un surplus de 15 în acel copil. | Doar pentru citire |
| grantOverage | Suma cu care totalAllocations depășește grantedQuantity. Dacă totalAllocations nu depășește grantedQuantity, această valoare este nulă sau zero. | Numai pentru citire |
| localLicensedQuantity | Suma acestei resurse acordată acestei organizații rămasă pentru utilizarea sa după ce cantitatea alocată copiilor este dedusă. Aceasta este suma afișată ca disponibilă în Admin Console. Această valoare poate fi zero, dar nu este niciodată negativă chiar dacă această organizație a supraalocată resurse copiilor săi. | Doar-pentru-citire |
| localUsage | Numărul de unități ale resursei utilizate în această organizație. De exemplu, delegarea unei Licențe de Utilizator unui utilizator ar conta ca 1 unitate de utilizare. | Doar pentru citire |
| totalUsage | Numărul de unități ale resursei utilizate de această organizație și de toți copiii. Aceasta arată utilizarea acestei resurse în partea hierarchiei organizației înrădăcinate de această organizație. | Doar-pentru-citire |
| useOverage | Suma utilizării totale peste alocarea organizației (organizația și copiii au utilizat mai mult din resursă decât este disponibil).Aceasta arată o valoare diferită de zero când totalUsage depășește localLicensedQuantity, | Doar citire |
| allowOverAllocation | Indică dacă utilizatorul are permisiunea să acorde mai multe resurse copiilor chiar dacă nu mai sunt de acordat (permis să acorde în ciuda depășirii limitei de acordare). Această valoare se aplică tuturor resurselor acestui produs.Dacă se încearcă actualizarea allowOverallocation pentru mai mult de o resursă din același produs la valori diferite, rezultatul este aleatoriu. | Poate fi actualizat când operation=Update |
| isPurchasedProduct | true dacă produsul este un produs achiziționat (nu alocat de părinte). Aceasta este echivalentul cu sourceLicenseId având o valoare goală. | Doar-pentru-citire |
| redistributable | true dacă produsul poate fi alocat copiilor, false înseamnă că produsul este disponibil doar în organizația în care este afișat și resursele nu pot fi alocate unei alte organizații. | Doar citire |
| operation | Una dintre blank, Create, Update sau Delete. Acțiunea de întreprins când datele sunt importate. |
Validarea datelor
- Câmpul operațiune trebuie să aibă o operațiune validă.
- Datele de import ale produsului trebuie să aibă proprietăți și valori pentru câmpurile obligatorii.
- Proprietățile datelor de import ale produsului trebuie să fie de tipul corect.
- Câmpul politicii produsului (overAllocation) nu trebuie furnizat pentru resurse diferite.
- Câmpul grantedQuantity:
- Nu poate fi schimbat în unlimited dacă nu este deja unlimited.
- Trebuie să fie un număr întreg non-negativ sau valoarea șir unlimited.
Validarea permisiunilor/accesibilității
- Organizația asociată cu datele de import trebuie să existe. Dacă actualizați, asigurați-vă că produsul și resursa asociată cu datele de import există cu adevărat.
Adaugă validarea produsului
- SourceLicenseId trebuie să existe.
- Organizația asociată cu noul produs trebuie să existe.
- Produsul care este creat nu trebuie să existe (produs cu același licenseId).
- Resursele asociate cu un produs care este creat trebuie să aibă un productId corespunzător care să se potrivească cu acel produs.
