Zaloguj się w serwisie Global Admin Console. Na karcie Organizacje otwórz selektor organizacji i wybierz hierarchię organizacyjną, którą chcesz wyeksportować. Eksportowane są dane wszystkich organizacji w hierarchii.
Ostatnia aktualizacja
17 cze 2025
Zobacz, jak administratorzy globalni mogą usprawnić zarządzanie organizacją i produktami dzięki funkcjom eksportu i importu dostępnym w serwisie Global Admin Console.
W serwisie Global Admin Console opcje na karcie Organizacje umożliwiają wyeksportowanie lub zaimportowanie struktury organizacyjnej, natomiast na karcie Przydzielanie produktów znajdują się dane przydzielania. Po kliknięciu ikony Więcej opcji można wybrać operację eksportu lub importu.
Eksportowanie struktury organizacyjnej
Administrator globalny może wyeksportować hierarchię organizacyjną, w postaci pliku JSON, CSV lub XLSX. Eksportować można całą hierarchię albo tylko jej podzbiór. Tak uzyskane dane można wykorzystać na potrzeby analizy lub do wprowadzenia modyfikacji.
Wybrany format eksportu determinuje strukturę eksportowanych danych.
- Format CSV umożliwia eksportowanie tylko jednego rodzaju danych naraz. Podczas eksportowania profili produktowych w formacie CSV profile i zasoby są łączone w jedną tabelę. Profil produktowy będzie mieć wiele pozycji — po jednej na każdy zasób.
- W przypadku formatu XLSX dane każdej organizacji są wyświetlane na osobnym arkuszu.
Pomiędzy rekordami różnych typów obiektów istnieją powiązania określane identyfikatorami referencyjnymi. Niekiedy może istnieć wiele wierszy dotyczących konkretnego obiektu. Ma to miejsce na przykład w przypadku obiektów typu Zasób, gdy z danym zasobem jest powiązany zbiór wartości.
- Format JSON jest najbardziej elastyczny i może wykorzystywać relacje strukturalne między eksportowanymi obiektami. Na przykład produkty w organizacji będą się znajdować bezpośrednio w elemencie tej organizacji. We wszystkich trzech formatach są eksportowane te same pola, jednak w formacie JSON niektóre wartości nie są potrzebne.
Kliknij ikonę Więcej opcji i wybierz polecenie Eksportuj.
W oknie dialogowym Eksportuj wybierz rodzaj informacji do wyeksportowania i format danych eksportu.
Wybierz opcję Eksportuj. Wygenerowanie pliku eksportu może potrwać kilka minut. Po zakończeniu, aby pobrać raport, przejdź do serwisu Global Admin Console > Informacje > Eksportuj raporty. Dowiedz się więcej o funkcji Eksportuj raporty.
Spostrzeżenie
Pliki JSON są eksportowane w formacie zip. Można je otworzyć za pomocą narzędzia zip lub analogicznej funkcji systemu operacyjnego.
Po pobraniu pliku możesz zmodyfikować dane, a następnie zaimportować je z powrotem. Zaimportowane aktualizacje pojawią się w serwisie Global Admin Console dokładnie tak samo, jak po ręcznej edycji danych.
Importowanie struktury organizacyjnej
Administrator globalny może importować zmodyfikowane dane. Po przesłaniu nowe dane zostaną porównane z bieżącymi i do hierarchii organizacyjnej zostaną zastosowane ewentualne zmiany. Wszystkie operacje importowania są wykonywane na zaktualizowanej kopii hierarchii organizacyjnej. Jeśli istnieją oczekujące zmiany, to zmiany pochodzące z operacji importu zostaną dodane do oczekujących zmian w hierarchii.
Zaloguj się w serwisie Global Admin Console. Na karcie Organizacje otwórz selektor organizacji i wybierz hierarchię organizacyjną, którą chcesz zaimportować.
Kliknij ikonę Więcej opcji 
i wybierz polecenie Importuj. W zależności od rozmiaru i złożoności importowanego pliku przetwarzanie tej operacji może potrwać od kilku sekund do kilku minut.
Kliknij opcję Wybierz plik i wybierz plik JSON, CSV lub XLSX, który chcesz przesłać. W przypadku pliku CSV można zaimportować tylko jeden rodzaj danych organizacji naraz. Ten format nie obsługuje importowania produktów.
Zaimportowane zmiany zostaną zaimplementowane w taki sam sposób, jakby były wprowadzone ręcznie.
Wybierz opcję Zamknij.
Kliknij opcję Przejrzyj oczekujące zmiany. Następnie kliknij opcję Zatwierdź zmiany, aby je zrealizować.
Zanim zmiany zostaną zrealizowane, serwis Global Admin Console wyświetla oczekujące operacje — w taki sam sposób, jak w przypadku zmian wprowadzanych ręcznie.
Schematy importu i eksportu
Jeśli dane są importowane z pliku CSV, kolejność pól jest dowolna, jednak pola muszą być zawsze zgodne z wierszem nagłówka.
Importując dane, należy określić operację do wykonania w odniesieniu do każdego elementu. Może to być jedna z następujących operacji:
- Update (aktualizacja) oznacza modyfikację danych.
- Create (utworzenie) oznacza, że zostanie utworzony nowy obiekt (np. organizacja, grupa użytkowników lub administrator).
- Delete (usunięcie) oznacza, że obiekt (np. organizacja, grupa użytkowników lub administrator) zostanie usunięty.
Rekordy wejściowe, które nie zawierają pola operacji lub w których to pole jest puste pole, będą ignorowane.
| Nazwa pola | Opis | Uwagi |
|---|---|---|
| id | Identyfikator organizacji. Przy dodawaniu nowej organizacji to pole może być puste lub zawierać identyfikator zastępczy, np. nowa_org_1. Identyfikatora zastępczego używa się wówczas, gdy inne importowane pozycje muszą odwoływać się do tej organizacji. Po utworzeniu zostanie przypisany rzeczywisty identyfikator organizacji, który zastąpi wszystkie wystąpienia identyfikatora zastępczego. |
Gdy operacja ma wartość CREATE (utwórz), można ustawić na wartość tymczasową. |
| name | Nazwa prosta organizacji. Minimalna długość 4, maksymalna 100. Nazwy mogą zawierać znaki UTF-8 do 3 bajtów; znaki 4-bajtowe nie są obsługiwane. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| countryCode | Kod kraju lub regionu | Musi być ustawiony, gdy operacja to CREATE; może zostać zmodyfikowany, gdy operacja to UPDATE. |
| type | Typ organizacji | Tylko do odczytu |
| parentOrgId | Identyfikator organizacji nadrzędnej. Puste w przypadku organizacji głównej. W przypadku modyfikacji obowiązują istotne ograniczenia, m.in. wymóg, że nowa jednostka nadrzędna musi się znajdować w tej samej hierarchii i mieć produkty, które są obecnie dodane w organizacji. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| adminCount | Liczba administratorów | Tylko do odczytu |
| domainCount | Liczba domen | Tylko do odczytu |
| userCount | Liczba użytkowników | Tylko do odczytu |
| userGroupCount | Liczba grup użytkowników | Tylko do odczytu |
| admins | Zbiór obiektów typu admin, reprezentujących administratorów tej organizacji |
Może nie istnieć, jeśli nie wybrano tych danych do eksportu. Wyświetlane na osobnej zakładce w plikach XLSX. |
| domains | Zbiór obiektów typu domena, reprezentujących domeny w tej organizacji |
|
| products | Zbiór obiektów typu produkt, reprezentujących produkty w tej organizacji |
|
| productProfiles | Zbiór obiektów typu „product profile”, reprezentujących profile produktowe w tej organizacji |
|
| userGroups | Zbiór obiektów typu „user group”, reprezentujących grupy użytkowników w tej organizacji |
|
| orgPolicies | Struktura reprezentująca zasady i ich wartości | |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. | Podczas eksportowania ta wartość jest zawsze pusta. |
Wymagania dotyczące importowania:
- W przypadku operacji UPDATE (modyfikowanie) lub DELETE (usuwanie) wartość orgId musi stanowić odniesienie do istniejącej organizacji w hierarchii.
- Jeśli tworzysz nową organizację, możesz pozostawić pole orgId puste lub wstawić w nim dowolny niepowtarzalny identyfikator, na przykład nowa-1 lub nowa-2. Dzięki temu powstanie identyfikator, którego można użyć w odwołaniach do planowanej organizacji.
- Kod kraju powinien być prawidłowy.
- Wartość orgId w operacjach UPDATE (modyfikacja) oraz DELETE (usuwanie) musi być identyfikatorem już istniejącym w hierarchii organizacyjnej.
- Identyfikatora orgId wybranego do operacji DELETE nie należy używać jako identyfikatora jednostki nadrzędnej (parentOrgId) organizacji wybranych do operacji UPDATE lub CREATE.
- Organizacje podrzędne znajdujące się na tym samym poziomie i mające tę samą jednostkę nadrzędną muszą mieć różne wartości orgName.
- W przypadku tworzenia organizacji lub zmiany jej nazwy taka nazwa nie może być identyczna z nazwą innej istniejącej organizacji podrzędnej mającej tę samą jednostkę nadrzędną.
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| orgId | Odniesienie do organizacji, w której znajduje się administrator. | Służy jako odniesienie umożliwiające wyszukiwanie obiektów powiązanych lub zawierających. |
| firstName | Imię użytkownika-administratora. Imię i nazwisko użytkowników kont Adobe ID można zastąpić wartością podaną przez użytkownika w chwili przyjmowania zaproszenia. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość |
| lastName | Nazwisko użytkownika-administratora. | |
| Adres e-mail administratora. Jest to klucz podstawowy konta użytkownika i musi być niepowtarzalny. | ||
| countryCode | Kod kraju lub regionu, w którym działa użytkownik. Dotyczy tylko kont Federated ID i Enterprise ID. |
|
| userType | Jeden z następujących typów: Adobe ID, Enterprise ID, Federated ID. | Tylko do odczytu |
| adminType | Jedna z następujących wartości: GLOBAL ADMIN, GLOBAL VIEWER, SYSTEM ADMIN, USER GROUP ADMIN, PRODUCT ADMIN, PRODUCT PROFILE ADMIN, DEPLOYMENT ADMIN, STORAGE_ADMIN. | Można ustawić tę wartość, gdy operacja to CREATE |
| groupId | Identyfikator grupy, której administratorem jest ten użytkownik. Dotyczy tylko administratorów grup użytkowników i profili produktowych. | |
| licenseId | Identyfikator licencji na produkt, którego administratorem jest ten użytkownik. Dotyczy tylko administratorów produktów. | |
| domain | Nazwa domeny użytkownika, jeśli inna niż domena z adresu e-mail | |
| userName | Nazwa konta użytkownika, jeśli inna niż adres e-mail | |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Wymagania dotyczące importowania:
- Pola orgId, email, adminType oraz userType muszą zawierać prawidłowe wartości.
- Pole countryCode musi zawierać prawidłowy kod kraju.
- Jeśli konto użytkownika już istnieje i jest modyfikowane, wartość userType musi być zgodna z typem tego konta.
- Sprawdź, czy w organizacji nie ma zduplikowanych adresów e-mail.
Eksport i import profilów produktowych obejmuje dwa segmenty: dane samego profilu produktowego oraz zbiór zasobów powiązanych z tym profilem. Zasoby te identyfikują usługi, które można skonfigurować — zazwyczaj włączyć je lub wyłączyć.
- W formacie JSON obiekty zasobów są zagnieżdżone w elemencie profilu produktowego.
- W formacie CSV lub XLSX profile produktowe i zasoby są łączone w jedną tabelę. Profil produktowy będzie mieć wiele pozycji — po jednej na każdy zasób.
- Pole „selected” w zasobie określa, czy usługa jest włączona.
- W przypadku importowania profilów produktowych konieczne jest umieszczenie operacji CREATE lub UPDATE zarówno w samym profilu, jak i w każdym obiekcie zasobu, który ma zostać utworzony lub zmodyfikowany.
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| productProfileId | Identyfikator profilu produktowego Podczas operacji tworzenia (CREATE) można użyć wartości zastępczej, aby inne obiekty mogły odwoływać się do nowego profilu. |
Gdy operacja ma wartość CREATE (utwórz), można ustawić na wartość tymczasową. |
| productProfileName | Nazwa profilu produktowego. Nie może powielać nazw innych profili produktowych lub grup użytkowników w tej samej organizacji. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| productProfileDescription | Opis tekstowy profilu produktowego | |
| licenseId | Kod referencyjny identyfikatora licencji na dany produkt | Służy jako odniesienie umożliwiające wyszukiwanie obiektów powiązanych lub zawierających. |
| orgId | Organizacja, która zawiera daną grupę użytkowników | |
| notifications | Wartość „true” (prawda) lub „false” (nieprawda), wskazująca, czy do użytkowników ma być wysyłane powiadomienie na e-mail w momencie dodania ich do tego profilu produktowego lub usunięcia z niego. | Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| resources | Tablica zasobów powiązanych z tym profilem produktowym. Pole zasobów jest obecne tylko w formacie JSON. W przypadku formatów CSV i XLSX zasoby są reprezentowane przez następujące dodatkowe pola: resourceName, resourceId, resourceDescription, icon, selected, quota, resourceType (odpowiednio: nazwa zasobu, identyfikator zasobu, opis zasobu, ikona, wybrane, limit przydziału, typ zasobu). Szczegółowy opis tych pól podano w artykule Produkty i zasoby. Jeśli profil produktowy zawiera więcej niż jeden zasób, to będzie wiele wierszy — po jednym na każdy zasób. Wartości w pozostałych polach każdego zasobu będą takie same. |
|
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Wymagania dotyczące importowania:
- Pola productProfileId, licenseId i orgId muszą zawierać prawidłowe wartości.
- Jeśli tworzony jest profil produktowy, wartość productProfileName musi być prawidłową nazwą i nie może być identyczna z nazwą innego profilu produktowego albo grupy użytkowników w tej samej organizacji.
- Pole „quota” (limit przydziału) musi mieć prawidłową wartość, odpowiednią do typu jednostki. Gdy resourceType=QUOTA, wartość ta jest numeryczna lub jest ciągiem „unlimited”; w przeciwnym razie wartość ta jest pusta.
- Pole „notification” (powiadomienie) musi mieć wartość true lub false.
- Jeśli importujesz dane z formatu CSV i XLSX sprawdź, czy obiekt productProfileId jest poprawny; wszystkie jego wpisy muszą mieć ten sam identyfikator orgId, licenseId i productProfileName.
- Sprawdź wartości productProfileName w pliku wejściowym oraz w organizacji.
- Profile, które mają zostać zmodyfikowane lub usunięte, muszą istnieć w organizacji.
- Zasoby, które mają zostać zmodyfikowane lub usunięte (dezaktywowane), muszą istnieć w profilu.
- Jeśli tworzysz profile, sprawdź następujące wymagania:
- Wartość orgId powinna wskazywać nową organizację albo organizację istniejącą.
- Wartość licenseId powinna wskazywać produkt nowy lub istniejący.
- Sprawdź poprawność zasobów w profilu.
Zasoby w profilach produktowych:
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| resourceName | Nazwa zasobu | Tylko do odczytu |
| resourceId | Identyfikator zasobu | Tylko do odczytu |
| resourceDescription | Opis tekstowy zasobu | Tylko do odczytu |
| icon | Adres URL obrazu reprezentującego zasób | Tylko do odczytu |
| selected | W przypadku wpisu konfiguracji określa, czy funkcja jest włączona. To pole występuje tylko w formacie JSON. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość |
| quota | Ilość podstawowego zasobu, którą można przydzielić użytkownikom za pośrednictwem tego profilu produktowego. To pole występuje tylko w formacie JSON. |
|
| resourceType | Typ zasobu. Jeśli jest obecny, ma wartość SERVICE. Wskazuje, że ten zasób reprezentuje usługę, którą można włączyć lub wyłączyć na podstawie wartości pola „selected”. To pole występuje tylko w formacie JSON. |
Tylko do odczytu |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Wymagania dotyczące importowania:
Pole operacji na zasobach jest ignorowane, gdy profil produktowy, do którego te zasoby należą, ma ustawione operacje Delete lub Create.
- Żaden z zasobów nie powinien być oznaczony do usunięcia — jest to nieprawidłowa operacja.
- Aby można było utworzyć profile produktowe, liczba zasobów powinna być zgodna z liczbą zasobów w źródłowym profilu produktowym.
- Jeśli zasób podlega operacji Update (modyfikacja), to musi być zasobem już obecnym w profilu produktowym.
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| userGroupId | Identyfikator grupy użytkowników Podczas operacji tworzenia (CREATE) można użyć wartości zastępczej, aby inne obiekty mogły odwoływać się do nowej grupy użytkowników. |
Gdy operacja ma wartość CREATE (utwórz), można ustawić na wartość tymczasową. |
| userGroupName | Nazwa grupy użytkowników | Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| userGroupDescription | Opis tekstowy grupy użytkowników | |
| userCount | Liczba użytkowników w grupie | Tylko do odczytu |
| profiles | Tablica identyfikatorów profili produktowych, z którymi powiązana jest grupa użytkowników. W formacie XLSX istnieje po jednym wierszu na wartość, z tymi samymi wartościami innych pól. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| orgId | Organizacja, która zawiera daną grupę użytkowników | Służy jako odniesienie umożliwiające wyszukiwanie obiektów powiązanych lub zawierających. |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Wymagania dotyczące importowania:
- Wartość orgId musi odwoływać się do istniejącej organizacji albo do organizacji tworzonej w tym samym zadaniu importowania.
- Wartość userGroupId musi odnosić się do istniejącej grupy przeznaczonej do modyfikacji (UPDATE) lub usunięcia (DELETE). Może to być identyfikator zdefiniowany dla nowych grup użytkowników.
- W operacjach modyfikacji (UPDATE) lub tworzenia (CREATE) pole userGroupNameorganization nie może być puste i ani zawierać wartości identycznej z nazwą innej grupy użytkowników lub profilu produktowego w tej samej organizacji.
- Upewnij się, że taka wartość userGroupName nie występuje nigdzie indziej w pliku wejściowym ani w organizacji.
- Grupy użytkowników, które mają zostać zmodyfikowane lub usunięte, muszą istnieć w organizacji.
- Profil, który ma zostać usunięty z grupy użytkowników, musi być obecny w tej grupie. Operacji UPDATE (modyfikacja) nie można wykonywać na profilu grupy użytkowników.
- Aby można było utworzyć grupy użytkowników, muszą zostać spełnione następujące wymagania:
- Wartość orgId powinna wskazywać nową organizację albo organizację istniejącą.
- Wartość licenseId, jeśli ma zastosowanie, powinna wskazywać produkt nowy lub istniejący.
- Wartość productProfileId powinna wskazywać nowy lub istniejący profil produktowy.
Pole „domena” zawiera informacje tylko do odczytu o domenach dostępnych w poszczególnych organizacjach. Tych danych nie można edytować.
|
Nazwa pola |
Opis |
Zastosowanie |
|---|---|---|
|
orgId |
Kod referencyjny organizacji, w której znajduje się ta domena |
Służy jako odniesienie umożliwiające wyszukiwanie obiektów powiązanych lub zawierających. |
|
domainName |
Nazwa domeny, na przykład adobe.com. |
Tylko do odczytu |
|
directoryName |
Nazwa katalogu, w którym znajduje się domena. |
Tylko do odczytu |
|
directoryType |
Federated ID albo Enterprise ID. |
Tylko do odczytu |
|
domainStatus |
Jedna z następujących wartości: ACTIVE, RESERVED, UNCLAIMED, CLAIMED, VALIDATED, WITHDRAWN, ACTIVE, EXPIRED (odpowiednio: aktywna, zastrzeżona, nieprzypisana, przypisana, zweryfikowana, wycofana, wygasła). |
Tylko do odczytu |
W plikach XLSX znajdują się dwa arkusze — jeden na produkty, a drugi na zasoby. W pliku JSON obiekty zasobów są zagnieżdżone w obiekcie produktu.
Produkty:
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| licenseId | Identyfikator danego produktu. Każdy produkt ma niepowtarzalny identyfikator licencji w organizacji, w której się znajduje. Identyfikator licencji tego samego produktu będzie różny w różnych organizacjach. Przy dodawaniu nowego produktu to pole może być puste lub zawierać identyfikator zastępczy, np. nowy_prod_1. Identyfikatora zastępczego używa się wówczas, gdy inne importowane pozycje muszą odwoływać się do tej instancji produktu. Po utworzeniu zostanie przypisany rzeczywisty identyfikator licencji, który zastąpi wszystkie wystąpienia identyfikatora zastępczego. |
Gdy operacja ma wartość CREATE (utwórz), można ustawić na wartość tymczasową. |
| productName | Nazwa produktu | Tylko do odczytu |
| productDescription | Opis tekstowy produktu | Tylko do odczytu |
| allowOverallocation | Wartość logiczna wskazująca, czy dozwolony jest nadprzydział tej instancji produktu. Nadprzydział to pojęcie oznaczające możliwość przydzielenia organizacji podrzędnej większej ilości zasobu, niż administrator otrzymał. |
Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość. |
| icon | Adres URL ikony produktu | Tylko do odczytu |
| sourceLicenseId | Identyfikator licencji danej instancji produktu w organizacji, z której ten produkt został przydzielony. Wartość zerowa (null), gdy dana instancja nie jest produktem przydzielonym, tylko produktem nabytym. | Można ustawić tę wartość, gdy operacja to CREATE |
| productId | Identyfikator produktu. | Tylko do odczytu |
| orgId | Identyfikator organizacji zawierającej tę instancję produktu | Służy jako odniesienie umożliwiające wyszukiwanie obiektów powiązanych lub zawierających. |
| redistributable | Wartość logiczna wskazująca, czy ten produkt ma zasoby, które można przyznać organizacjom podrzędnym. | Tylko do odczytu |
| resources | Obiekt zawierający zbiór obiektów zasobów, reprezentujących zasoby i ustawienia w tym produkcie | |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Wymagania dotyczące importowania:
- W przypadku operacji CREATE wartość licenseId musi stanowić niepowtarzalny identyfikator utworzony przez administratora.
- W przypadku operacji UPDATE wartość licenseId musi być identyfikatorem istniejącego produktu w określonej organizacji.
- Wartość orgId musi odwoływać się do istniejącej organizacji albo do organizacji tworzonej w tym samym zadaniu importowania.
- W przypadku operacji CREATE wartość sourceLicenseId musi odnosić się do istniejącego produktu lub zdefiniowanego przez administratora identyfikatora produktu tworzonego w tym samym zadaniu importowania.
- W przypadku produktów objętych operacją Create wartości licenseId oraz sourceLicenseId nie powinny być takie same.
- Sprawdź organizacje, do których należą produkty. Powinna to być nowa organizacja albo organizacja już istniejąca w hierarchii organizacyjnej.
- W operacjach UPDATE (modyfikacja) oraz DELETE (usuwanie) produkt musi już istnieć w hierarchii organizacyjnej.
- Identyfikatora licenseId wybranego do operacji DELETE nie należy używać jako źródłowego identyfikatora licencji (sourceLicenseId) produktów wybranych do operacji UPDATE lub CREATE.
- W przypadku produktów objętych operacją Create należy sprawdzić, czy w organizacji nadrzędnej powinien znajdować się źródłowy identyfikator licencji (sourceLicenseId).
Zasoby produktów:
Obiekty zasobów mogą znajdować się w produktach i profilach produktowych.
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| resourceName | Nazwa zasobu | Tylko do odczytu |
| resourceId | Identyfikator zasobu | Tylko do odczytu |
| resourceDescription | Opis tekstowy zasobu | Tylko do odczytu |
| icon | Adres URL obrazu reprezentującego zasób | Tylko do odczytu |
| productName | Nazwa produktu, którego częścią jest ten zasób. | Tylko do odczytu |
| licenseId | Identyfikator licencji (instancji produktu) na produkt, którego częścią jest ten zasób. | Służy jako odniesienie umożliwiające wyszukiwanie obiektów powiązanych lub zawierających. |
| grantedQuantity | Przyznana ilość tego zasobu. Oznacza to ilość zasobów, które ta organizacja ma do wykorzystania lokalnie lub przydzielenia organizacjom podrzędnym. | Gdy operacja to CREATE lub UPDATE, można odpowiednio ustawić lub zmodyfikować tę wartość |
| unit | Nazwa jednostki, która mierzy ilość przydziału. | Tylko do odczytu |
| currentQuantity | Aktualna ilość do wykorzystania w tej organizacji. Jest to wartość grantedQuantity pomniejszona o zasoby przydzielone organizacjom podrzędnym. Ta wartość jest wyświetlana w serwisie Admin Console w odniesieniu do danego produktu/zasobu. | Tylko do odczytu |
| provisionedQuantity | Ilość faktycznie skonfigurowana; może być mniejsza niż wartość przydziału lub ilość aktualna; może być mniejsza niż wartość currentQuantity, jeśli wprowadzono jakieś ograniczenia. | Tylko do odczytu |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Wymagania dotyczące importowania:
Pole operacji na zasobach jest ignorowane, gdy produkt, do którego te zasoby należą, ma ustawione operacje Delete lub Create.
- Żaden z zasobów nie powinien być oznaczony do usunięcia — jest to nieprawidłowa operacja.
- Aby można było utworzyć produkty, liczba zasobów powinna być zgodna z liczbą zasobów w produkcie źródłowym.
- Jeśli zasób podlega operacji Update (modyfikacja), to musi być zasobem już obecnym w produkcie.
Importowanie i eksportowanie danych dotyczących przydziału produktów
Administrator globalny może wyeksportować dane przydziału produktów w postaci pliku JSON lub CSV. Dane w takim pliku można następnie zmodyfikować i przesłać z powrotem, aby zaimportować zmiany. Po przesłaniu nowe dane są porównywane z danymi bieżącymi. Następnie przydziały produktów są modyfikowane odpowiednio do zmian w przesłanych danych. Aby zmiany weszły w życie, administrator dokonuje ich przeglądu i zatwierdza je do realizacji.
Eksportowanie modelu alokacji produktów
Aby wyeksportować model alokacji produktów, wykonaj następujące czynności:
- Zaloguj się do serwisu Global Admin Console i przejdź na kartę Przydzielanie produktów.
- Kliknij ikonę Więcej opcji , a następnie wybierz polecenie Eksportuj CSV lub Eksportuj JSON. Zostanie pobrany plik Tutaj podano więcej informacji o formatach eksportu.
Importowanie modelu alokacji produktów
Można wyeksportować dane, zmodyfikować je, a następnie zaimportować zmodyfikowany plik. Aby zaimportować model alokacji produktów, wykonaj następujące czynności:
- Zaloguj się do serwisu Global Admin Console i przejdź na kartę Przydzielanie produktów.
- Kliknij ikonę Więcej opcji i wybierz polecenie Importuj.
- Wybierz plik JSON lub CSV do przesłania.
- Kliknij opcję Przejrzyj oczekujące zmiany. Gdy zakończysz przegląd zmian, kliknij opcję Zatwierdź zmiany, aby je zrealizować.
Formaty eksportu i importu danych alokacji produktów
Formaty eksportu i importu są takie same. Jeśli dane są importowane w formacie CSV, kolejność pól jest dowolna, jednak pola muszą być zawsze zgodne z wierszem nagłówka. W przypadku importu w formacie JSON pola mogą występować w dowolnej kolejności.
Importując dane alokacji produktów, należy określić operację do wykonania. Może to być jedna z następujących operacji:
- Update (modyfikuj): Oznacza modyfikację wartości grantedQuantity, allowOverAllocation.
- Create (utwórz): Oznacza, że zasób produktowy ma zostać dodany do wskazanej organizacji.
- Delete (usuń): Oznacza, że produkt ma zostać usunięty.
Jeśli operacja nie zostanie podana, to podczas importowania danego wiersza (CSV) lub obiektu (JSON) nie zostaną wykonane żadne zmiany.
Wyeksportowany plik zawiera po jednym wierszu lub rekordzie na każdy zasób produktowy. Niektóre produkty mają więcej niż jeden zasób.
Jeśli produkt ma więcej niż jeden zasób, operacje modyfikacji (Update) mogą być do nich stosowane niezależnie; operacja Delete usuwa z organizacji cały produkt wraz z wszystkimi zasobami, natomiast w przypadku operacji tworzenia (Create) w importowanym pliku należy zdefiniować rekord odpowiadający każdemu z zasobów, aby umożliwić podanie ich ilości. Pole allowOverAllocation (zezwalaj na nadprzydział) obowiązuje w stosunku do całego produktu i nie ma znaczenia, w którym zasobie zostanie zmodyfikowane.
| Nazwa pola | Opis | Zastosowanie |
|---|---|---|
| productName | Nazwa produktu. | Tylko do odczytu |
| licenseId | Identyfikator produktu (niepowtarzalny wśród produktów w organizacji). Przy dodawaniu nowego produktu to pole może być puste lub zawierać identyfikator zastępczy, np. nowy_prod_1. Identyfikatora zastępczego używa się wówczas, gdy inne importowane pozycje muszą odwoływać się do tego produktu. Po utworzeniu zostanie przypisany rzeczywisty identyfikator licencji, który zastąpi wszystkie wystąpienia identyfikatora zastępczego. |
Można ustawić tę wartość, gdy operacja to CREATE |
| sourceLicenseId | Identyfikator produktu nadrzędnego. Jest pusty lub ma wartość null, jeśli reprezentuje zakup zamiast alokacji. | Można ustawić tę wartość, gdy operacja to CREATE |
| productId | Identyfikator tej klasy produktów. Jest współużytkowany przez produkty tego samego typu i różni się od identyfikatora licencji, który identyfikuje instancję tego produktu. | Tylko do odczytu |
| resourceName | Nazwa tego zasobu produktowego. Na przykład „licencje użytkownika”. | Tylko do odczytu |
| resourceId | Identyfikator tego zasobu produktowego. | Można ustawić tę wartość, gdy operacja to CREATE |
| orgPathName | Nazwa ścieżki organizacji, w której znajduje się ten zasób produktowy. Segmenty są oddzielone znakami „/”. | Tylko do odczytu |
| orgName | Nazwa prosta organizacji, w której znajduje się ten zasób produktowy. Jest to ostatni segment ścieżki orgPathName. | Tylko do odczytu |
| orgId | Identyfikator organizacji, w której znajduje się ten zasób produktowy. | Można ustawić tę wartość, gdy operacja to CREATE |
| grantedQuantity | Ilość zasobu (liczba jednostek) przyznana tej organizacji przez jej organizację nadrzędną albo ilość zakupiona, jeśli ten wpis zasobu produktowego reprezentuje zakup. To pole może być modyfikowane, jednak nie w przypadku produktów zakupionych lub alokacji na poziomie głównym, których nie ma prawa zmieniać administrator globalny. |
Można modyfikować, gdy operacja to UPDATE lub CREATE |
| unit | Nazwa jednostki zasobu. Na przykład „Użytkownicy”. | Tylko do odczytu |
| totalAllocations | Suma przydziałów tego zasobu produktowego przyznanych przez tę organizację jej organizacjom podrzędnym. Ta wartość obejmuje bezpośrednie przydziały do organizacji bezpośrednio podporządkowanych oraz nadprzydziały dokonane przez te organizacje. Załóżmy na przykład, że organizacja przyznała swojej organizacji podrzędnej 10 jednostek, a ta z kolei przydzieliła swojej organizacji podrzędnej 25 jednostek. Wartość totalAllocations wyniesie wówczas 25: w tym 10 przyznane organizacji podrzędnej i nadprzydział kolejnych 15, które przyznała ona swojej organizacji podrzędnej. | Tylko do odczytu |
| grantOverage | Wielkość, o jaką wartość totalAllocations przekracza wartość grantedQuantity. Jeśli wartość totalAllocations nie przekracza wartości grantedQuantity, ten parametr ma wartość null lub zero. | Tylko do odczytu |
| localLicensedQuantity | Ilość tego zasobu przydzielonego tej organizacji, jaka pozostaje do wykorzystania przez nią po odliczeniu ilości przydzielonych jej organizacjom podrzędnym. Jest to ilość wskazywana jako dostępna w serwisie Admin Console. Ta wartość może wynosić zero, ale nigdy nie jest ujemna, nawet jeśli ta organizacja dokonała nadprzydziału zasobów swoim organizacjom podrzędnym. | Tylko do odczytu |
| localUsage | Liczba jednostek zasobu wykorzystywanych w tej organizacji. Na przykład przydzielenie użytkownikowi jednej „licencji użytkownika” liczy się jako wykorzystanie 1 jednostki. | Tylko do odczytu |
| totalUsage | Liczba jednostek zasobu wykorzystywanych przez tę organizację i przez wszystkie jej organizacje podrzędne. Wskazuje wykorzystanie zasobu w całej gałęzi drzewa hierarchii, której podstawą jest dana organizacja. | Tylko do odczytu |
| useOverage | Całkowita wykorzystana ilość, która przekracza wielkość przydziału przyznanego tej organizacji (a zatem organizacja i jej elementy podrzędne wykorzystały większą ilość zasobu, niż jest dostępna). Pokazuje wartość różną od zera, gdy totalUsage przekracza localLicensedQuantity. | Tylko do odczytu |
| allowOverAllocation | Określa, czy użytkownik może przydzielać jednostkom podrzędnym więcej zasobów, nawet w sytuacji, gdy nic już nie pozostało do rozdzielenia (zezwolenie na przydział mimo przekroczenia limitu). Ta wartość ma zastosowanie do wszystkich zasobów danego produktu. Jeśli zostanie podjęta próba modyfikacji zmiennej allowOverallocation w więcej niż jednym zasobie tego samego produktu i ustawienia jej na różne wartości, to rezultat zostanie określony losowo. | Można modyfikować, gdy operacja to UPDATE |
| isPurchasedProduct | Wartość „true” (prawda), jeśli produkt jest produktem zakupionym (a nie przydzielonym przez organizację nadrzędną). Równoważne z pustą wartością pola sourceLicenseId. | Tylko do odczytu |
| redistributable | Wartość „true” (prawda), jeśli ten produkt może być przydzielany organizacjom podrzędnym. Wartość „false” (nieprawda) oznacza, że produkt ten jest dostępny tylko w organizacji, w której jest widoczny i nie można przydzielać jego zasobów organizacjom podrzędnym. | Tylko do odczytu |
| operation | Operacja mająca jedną z następujących wartości: brak (puste), Create, Update lub Delete. Określa ona rodzaj czynności, która ma zostać wykonana podczas importowania danych. |
Walidacja danych
- Pole „operation” musi zawierać poprawną operację.
- Importowane dane produktów muszą zawierać odpowiednie właściwości i wartości w wymaganych polach.
- Właściwości w importowanych danych produktów muszą mieć poprawny typ.
- Pole zasady produktu (overAllocation) nie może być określone w odniesieniu do więcej niż jednego zasobu.
- Pole grantedQuantity:
- Nie może zostać zmodyfikowane na wartość unlimited (bez ograniczeń), jeśli poprzednio nie miało wartości unlimited.
- Musi być nieujemną liczbą całkowitą lub ciągiem o wartości unlimited.
Walidacja uprawnień i dostępności
- Musi istnieć organizacja powiązana z danymi importu. Jeśli wprowadzasz modyfikacje, upewnij się, że produkt i zasób powiązane z danymi importu rzeczywiście istnieją.
Walidacja przy dodawaniu produktu
- Musi istnieć identyfikator SourceLicenseId.
- Musi istnieć organizacja powiązana z nowym produktem.
- Tworzony produkt nie może już istnieć (nie może być produktu z tym samym identyfikatorem licenseId).
- Zasoby skojarzone z tworzonym produktem muszą mieć odpowiedni identyfikator productId, który jest zgodny z danym produktem.
