Esporta o importa la struttura dell’organizzazione e le allocazioni di prodotti
Si applica a: Enterprise
Scopri come gli amministratori globali possono semplificare l’organizzazione e la gestione dei prodotti con le funzioni di esportazione e importazione in Global Admin Console.
Accedi alla scheda Organizzazioni in Global Admin Console per esportare o importare la struttura dell’organizzazione. Vai alla scheda Allocazione prodotto per visualizzare i dati di allocazione. Seleziona l’icona Altre opzioni (⋮), quindi scegli Esporta o Importa. Vai qui per accedere a Global Admin Console.
Esportare la struttura dell’organizzazione
In qualità di amministratore globale, puoi esportare la gerarchia dell’organizzazione. È possibile scaricare una rappresentazione JSON, CSV o XLSX dell’intera gerarchia organizzativa o di un suo sottoinsieme. Puoi quindi utilizzare questi dati per l’analisi o la modifica.
Il formato di esportazione scelto influisce sulla struttura dei dati esportati:
- Formato CSV — consente di esportare un solo tipo di dati alla volta. Durante l’esportazione dei profili di prodotto in formato CSV, i profili e le risorse vengono combinati in un’unica tabella. Sono disponibili più voci per il profilo di prodotto, una per ogni risorsa.
- Formato XLSX - Consente di visualizzare i dettagli di ogni organizzazione in un foglio separato. I record sono collegati tra i diversi tipi di oggetto da un ID di riferimento. In alcuni casi, possono essere presenti più righe per un particolare oggetto (ad esempio, oggetti Resource se a una determinata risorsa è associato un set di valori).
- Formato JSON: il più flessibile. Può sfruttare le relazioni strutturali tra gli oggetti esportati (ad esempio, i prodotti di un’organizzazione appaiono direttamente nell’elemento organizzazione). Gli stessi campi vengono esportati in tutti e tre i formati, ma alcuni valori sono ridondanti nel formato JSON.
Passaggi da esportare
-
Accedi a Global Admin Console. Nella scheda Organizzazioni, utilizza il selettore organizzazione per selezionare la gerarchia organizzazione in cui desideri esportare. Vengono esportati i dati per tutte le organizzazioni nella gerarchia.
-
Seleziona l’icona Altre opzioni ⋮ e scegli Esporta.
-
Nella finestra di dialogo Esporta, seleziona gli elementi da esportare e un formato in cui esportare i dati.
-
Seleziona Esporta. La generazione del file di esportazione può richiedere alcuni minuti. Una volta completato, per scaricare il report, passa a Global Admin Console > Insights > Esporta report.
Dopo aver scaricato il file, puoi manipolare i dati e quindi importarli nuovamente. Gli aggiornamenti importati vengono visualizzati in Global Admin Console come se i dati fossero stati modificati manualmente.
Importare la struttura dell’organizzazione
In qualità di amministratore globale, puoi importare dati potenzialmente modificati. Una volta caricati, i nuovi dati vengono confrontati con i dati correnti e le eventuali modifiche vengono applicate alla gerarchia dell’organizzazione. Tutte le operazioni di importazione vengono eseguite sulla copia aggiornata della gerarchia organizzazione. Se sono presenti modifiche in sospeso, le modifiche importate vengono aggiunte alle modifiche in sospeso esistenti nella gerarchia.
Passaggi per importare
- Accedi a Global Admin Console. Nella scheda Organizzazioni, utilizza il selettore organizzazione per selezionare la gerarchia organizzazione in cui desideri eseguire l’importazione.
- Seleziona l’icona Altre opzioni ⋮ e seleziona Importa. A seconda delle dimensioni e della complessità del file di importazione, l’elaborazione può richiedere da alcuni secondi a diversi minuti.
- Seleziona Seleziona un file e scegli un file JSON, CSV o XLSX da caricare. Per il file CSV, è possibile importare un solo dettaglio dell’organizzazione alla volta e non supporta l’importazione di prodotti. Le modifiche importate vengono visualizzate come se i dati fossero stati modificati manualmente.
- Seleziona Chiudi.
- Selezionare Rivedi modifiche in sospeso. Quindi, seleziona Invia modifiche per eseguirle. Prima di eseguire le modifiche, le azioni in sospeso vengono visualizzate nello stesso modo di quando le modifiche vengono apportate manualmente in Global Admin Console.
Esportare e importare schemi
Durante l’importazione di dati utilizzando un file CSV, i campi possono essere visualizzati in qualsiasi ordine ma devono sempre corrispondere alla riga di intestazione.
Durante l’importazione dei dati, è necessario specificare un’operazione per ciascun elemento. L’operazione può essere una delle seguenti:
- Aggiorna: indica una modifica.
- Crea: indica la creazione di un nuovo oggetto, ad esempio organizzazione, gruppo di utenti o amministratore.
- Elimina: indica l’eliminazione di un oggetto (ad esempio organizzazione, gruppo di utenti o amministratore).
I record di input senza campo di operazione o con campo vuoto vengono ignorati.
Organizzazioni
Requisiti di importazione:
- Per l’aggiornamento o l’eliminazione, l’ID organizzazione deve fare riferimento a un’organizzazione esistente nella gerarchia.
- Se stai creando una nuova organizzazione, puoi lasciare vuoto il campo orgId o impostarlo su un ID univoco che puoi creare (ad esempio nuovo-1 o nuovo-2). Questo fornisce un ID che può essere utilizzato per fare riferimento all’organizzazione da creare.
- Il codice paese deve essere valido.
- L’orgId per l’operazione Update e Delete deve essere già presente nella gerarchia organizzazione.
- L’orgId contrassegnato come Delete non deve essere selezionato come parentOrgId per le organizzazioni con Update o Create operazione.
- Le organizzazioni figlio allo stesso livello e dello stesso padre non devono avere gli stessi nomi organizzazione.
- Per creare un’organizzazione o aggiornarne il nome, il nome dell’organizzazione non deve corrispondere al nome di un elemento figlio esistente dello stesso elemento padre.
Amministratori
Requisiti di importazione:
- orgId, e-mail, adminType e userType devono contenere valori validi.
- countryCode deve essere valido.
- Se l’utente esiste già e viene aggiornato, userType deve corrispondere all’utente.
- Verifica la presenza di indirizzi e-mail duplicati nell’organizzazione.
Profili di prodotto
Le esportazioni e le importazioni di profili di prodotto sono costituite da due parti: i dettagli del profilo di prodotto e un set di risorse associate al profilo di prodotto. Queste risorse identificano i servizi che possono essere configurati, in genere solo per abilitarli o disabilitarli.
- Gli oggetti risorsa sono nidificati all’interno del profilo di prodotto in formato JSON.
- Quando utilizzi CSV o XLSX con i profili di prodotto, questi ultimi e le relative risorse vengono combinati in un’unica tabella. Ci saranno più voci per il profilo di prodotto, una per ogni risorsa.
- Il campo selezionato nella risorsa controlla se il servizio è abilitato.
- Durante l’importazione dei profili di prodotto, è necessario eseguire un’operazione Crea o Aggiorna sul profilo di prodotto stesso e su tutti gli oggetti risorsa da aggiornare o creare.
Requisiti di importazione:
-
productProfileId, licenseId e orgId devono avere valori validi.
-
Durante la creazione di un profilo di prodotto, productProfileName deve essere un nome valido e non deve duplicare un altro nome di profilo di prodotto o di gruppo di utenti nella stessa organizzazione.
-
Il campo quota deve contenere un valore valido per il tipo di unità. Questo valore è numerico o illimitato se resourceType=QUOTA o vuoto in caso contrario.
-
Il campo di notifica deve essere true o false.
-
Per le importazioni CSV e XLSX, convalida productProfileId; tutte le voci devono avere gli stessi orgId, licenseId e productProfileName.
-
Convalida productProfileName duplicato nel file di input e nell’organizzazione.
-
I profili da aggiornare ed eliminare devono essere presenti nell’organizzazione.
-
Le risorse da aggiornare ed eliminare (disattivate) devono essere presenti nel profilo.
-
Per creare i profili, verifica quanto segue:
- L’orgId deve essere una nuova organizzazione o un’organizzazione esistente.
- LicenseId deve essere un nuovo prodotto o un prodotto esistente.
- Convalida le risorse per il profilo.
Risorse nei profili di prodotto
Requisiti di importazione:
- Il campo Operazione sulle risorse viene ignorato quando per il profilo di prodotto a cui appartengono sono impostate operazioni come Elimina o Crea.
- Nessuna risorsa deve essere contrassegnata per l’eliminazione. Operazione non valida.
- Per creare i profili di prodotto, il numero di risorse deve corrispondere al numero di risorse del profilo di prodotto sorgente.
- Per le risorse con l’operazione Update, la risorsa deve essere presente nel profilo di prodotto.
Gruppi di utenti
Requisiti di importazione:
-
orgId deve fare riferimento a un’organizzazione esistente o in fase di creazione nella stessa importazione.
-
userGroupId deve fare riferimento a un gruppo esistente per l’aggiornamento o l’eliminazione e può essere un ID definito per i nuovi gruppi di utenti.
-
Per l’aggiornamento o la creazione, userGroupName non deve essere vuoto e non deve duplicare un altro nome di profilo utente o di prodotto nella stessa organizzazione.
-
Verificare che userGroupName non sia duplicato nel file di input e nell’organizzazione.
-
userGroups da aggiornare ed eliminare deve essere presente nell’organizzazione.
-
Il profilo da rimuovere dal gruppo di utenti deve essere presente nel gruppo di utenti. Impossibile eseguire operazioni di aggiornamento sul profilo di un gruppo di utenti.
-
Per creare i gruppi di utenti, verifica quanto segue:
- L’orgId deve essere una nuova organizzazione o un’organizzazione esistente.
- Il licenseId, se applicabile, deve essere un nuovo prodotto o un prodotto esistente.
- ProductProfileId deve essere un nuovo profilo di prodotto o un profilo di prodotto esistente.
Domini
Le informazioni sul dominio forniscono informazioni di sola lettura sui domini disponibili in ogni organizzazione. Dati non modificabili.
Prodotti e risorse products-and-resources
Nei file XLSX sono disponibili due fogli, uno per i prodotti e uno per le risorse. In JSON, gli oggetti risorsa sono nidificati nell’oggetto prodotto.
Prodotti
Requisiti di importazione:
- Per creare, licenseId deve essere un ID univoco creato dall’utente.
- Per l’aggiornamento, licenseId deve essere l’ID di un prodotto esistente nell’organizzazione specificata.
- orgId deve fare riferimento a un’organizzazione esistente o che viene creata nella stessa operazione di importazione.
- Per creare, sourceLicenseId deve fare riferimento a un prodotto esistente o all’ID definito per un prodotto creato nella stessa operazione di importazione.
- licenseId e sourceLicenseId non devono essere uguali per i prodotti con l’operazione Create.
- Convalidare organizzazioni di prodotti; l’organizzazione deve essere nuova o già presente nella gerarchia dell’organizzazione.
- Per l’operazione Aggiorna e Elimina, il prodotto deve essere già presente nella gerarchia dell’organizzazione.
- licenseId contrassegnato come Delete non deve essere utilizzato come sourceLicenseId di prodotti con Create e Update operazione.
- Per i prodotti con l’operazione Create, verificare che sourceLicenseId sia presente nell’organizzazione padre.
Risorse per i prodotti
Gli oggetti risorsa possono essere visualizzati nei prodotti e nei profili di prodotto.
Requisiti di importazione:
Il campo Operazione sulle risorse viene ignorato quando per il prodotto a cui appartengono sono impostate operazioni come Elimina o Crea.
- Nessuna risorsa deve essere contrassegnata per l’eliminazione. Operazione non valida.
- Per i prodotti da creare, il numero di risorse deve corrispondere al numero di risorse del prodotto di origine.
- Per le risorse con l’operazione Update, la risorsa deve essere presente nel prodotto.
Importare ed esportare dati di allocazione prodotti
In qualità di Amministratore globale, puoi esportare i dati di allocazione prodotto come file JSON o CSV. Puoi quindi modificare questi dati e caricarli per importare le modifiche. Quando vengono caricati i dati potenzialmente modificati, i nuovi dati vengono confrontati con i dati correnti e le eventuali modifiche vengono applicate ai dati di allocazione del prodotto. È quindi possibile rivedere e sottomettere le modifiche in sospeso affinché diventino effettive.
Esporta il modello di allocazione prodotto
Per esportare il modello di allocazione prodotto, effettuare le seguenti operazioni:
- Accedi a Global Admin Console e passa alla scheda Allocazione prodotti.
- Seleziona l’icona di ⋮ Altre opzioni, quindi seleziona Esporta CSV o Esporta JSON. Il file è stato scaricato. Ulteriori informazioni sui formati di esportazione.
Importa il modello di allocazione prodotto
È possibile esportare i dati, modificarli e quindi importare il file modificato. Per importare il modello di allocazione prodotto, effettuare le seguenti operazioni:
- Accedi a Global Admin Console e passa alla scheda Allocazione prodotti.
- Seleziona l’icona Altre opzioni ⋮ e seleziona Importa.
- Seleziona un file JSON o CSV da caricare.
- Selezionare Rivedi modifiche in sospeso. Dopo aver esaminato le modifiche, seleziona Invia modifiche per eseguirle.
Esportazione e importazione di formati per l’allocazione dei prodotti
I formati di esportazione e importazione sono gli stessi. Durante l’importazione in formato CSV, i campi possono essere visualizzati in qualsiasi ordine, ma devono corrispondere alla riga di intestazione. Durante l’importazione in formato JSON, i campi possono essere visualizzati in qualsiasi ordine.
È necessario specificare l’operazione durante l’importazione dei dati di allocazione prodotto. L’operazione può essere una delle seguenti:
- Aggiorna: indica una modifica (modifica ai valori grantQuantity, allowOverAllocation).
- Crea: indica di aggiungere una risorsa prodotto all’organizzazione specificata.
- Elimina: indica l’eliminazione del prodotto.
Se non viene specificata alcuna operazione, non si verificano modifiche quando i dati vengono importati per quella riga in CSV o nell’oggetto in JSON.
Nel file esportato esiste una riga o un record per ogni risorsa prodotto. Alcuni prodotti hanno più di una risorsa.
Se un prodotto dispone di più risorse, le operazioni di aggiornamento possono essere applicate a risorse indipendenti, un’operazione di eliminazione elimina il prodotto, incluse tutte le risorse, da un’organizzazione e un’operazione di creazione richiede un record per ciascuna delle risorse nel file di importazione in modo da poter specificare la quantità corretta di ciascuna risorsa. Il campo allowOverAllocation si applica a tutto il prodotto e non importa in quale risorsa si trovi un aggiornamento per questo campo.
Descrizione delle intestazioni
Requisiti per l’importazione
Convalida dei dati
-
Il campo dell’operazione deve contenere un’operazione valida.
-
I dati di importazione del prodotto devono avere proprietà e valori per i campi obbligatori.
-
Le proprietà dei dati di importazione del prodotto devono essere del tipo corretto.
-
Il campo criterio prodotto (overAllocation) non deve essere fornito per risorse diverse.
-
Il campo grantQuantity:
- Non può essere cambiato in unlimited se non è già unlimited.
- Deve essere un numero intero non negativo o il valore stringa unlimited.
Autorizzazione/convalida accessibile
- L’organizzazione associata ai dati di importazione deve esistere. Se stai eseguendo l’aggiornamento, accertati che il prodotto e la risorsa associati ai dati di importazione esistano effettivamente.
Aggiungi convalida prodotto
- SourceLicenseId deve esistere.
- L’organizzazione associata al nuovo prodotto deve esistere.
- Il prodotto da creare non deve esistere (prodotto con lo stesso licenseId).
- Le risorse associate a un prodotto in fase di creazione devono avere un productId corrispondente a tale prodotto.