Organisationsstruktur und Produktzuordnungen exportieren oder importieren
Gilt für: Enterprise
Erfahren Sie, wie globale Administratoren die Organisations- und Produktverwaltung mit Export- und Importfunktionen in der Global Admin Console optimieren können.
Greifen Sie auf die Organisationen in der Global Admin Console zu um die Organisationsstruktur zu exportieren oder zu importieren. Gehen Sie zur Registerkarte Produktzuordnung, um Zuordnungsdaten anzuzeigen. Wählen Sie das Symbol Weitere Optionen (⋮) aus und wählen Sie dann Exportieren oder Importieren. Klicken Sie hier melden Sie sich bei der Global Admin Console an.
Exportieren der Organisationsstruktur
Als globaler Administrator können Sie die Organisationshierarchie exportieren. Sie können eine JSON-, CSV- oder XLSX-Darstellung der gesamten Organisationshierarchie oder einer Untergruppe davon herunterladen. Sie können diese Daten dann zur Analyse oder Änderung verwenden.
Das ausgewählte Exportformat wirkt sich auf die Struktur der exportierten Daten aus:
- CSV-Format - Ermöglicht den Export von jeweils nur einer Art von Daten. Beim Exportieren von Produktprofilen im CSV-Format werden die Profile und Ressourcen zu einer Tabelle zusammengefasst. Für das Produktprofil gibt es mehrere Einträge, einen für jede Ressource.
- XLSX-Format - Ergibt, dass jedes Organisationsdetail in einem separaten Blatt angezeigt wird. Datensätze sind zwischen den verschiedenen Objekttypen durch eine Referenz-ID verbunden. In einigen Fällen kann es mehrere Zeilen für ein bestimmtes Objekt geben (z. B. Ressourcenobjekte, wenn ein Satz von Werten mit einer bestimmten Ressource verknüpft ist).
- JSON-Format - Das flexibelste. Es können strukturelle Beziehungen zwischen exportierten Objekten genutzt werden (z. B. erscheinen Produkte in einer Organisation direkt im Organisationselement). Dieselben Felder werden in alle drei Formate exportiert, aber einige Werte im JSON-Format sind redundant.
Zu exportierende Schritte
-
Melden Sie sich bei der Global Admin Console an. Verwenden auf der Registerkarte Organisationen“ die Organisationsauswahl, um die Organisationshierarchie auszuwählen, in die Sie exportieren möchten. Daten für alle Organisationen in der Hierarchie werden exportiert.
-
Wählen Sie das ⋮ Weitere Optionen und dann Exportieren aus.
-
Wählen Dialogfeld „Exportieren aus, was exportiert werden soll und in welchem Format die Daten exportiert werden sollen.
-
Wählen Sie Exportieren aus. Es kann mehrere Minuten dauern, bis die Exportdatei erstellt ist. Um den Bericht herunterzuladen, gehen Sie nach Abschluss des Vorgangs zu Global Admin Console > Insights > Berichte exportieren.
Nach dem Herunterladen der Datei können Sie die Daten bearbeiten und dann wieder importieren. Die importierten Aktualisierungen werden in der Global Admin Console so angezeigt, als hätten Sie die Daten manuell bearbeitet.
Organisationsstruktur importieren
Als globaler Administrator können Sie potenziell geänderte Daten importieren. Beim Hochladen werden die neuen Daten mit den aktuellen Daten verglichen und alle Änderungen werden auf die Organisationshierarchie angewendet. Alle Importvorgänge werden mit der aktualisierten Kopie der Organisationshierarchie durchgeführt. Wenn Sie ausstehende Änderungen haben, werden importierte Änderungen zusätzlich zu den vorhandenen ausstehenden Änderungen in der Hierarchie hinzugefügt.
Importschritte
- Melden Sie sich bei der Global Admin Console an. Verwenden auf der Registerkarte Organisationen“ die Organisationsauswahl, um die Organisationshierarchie auszuwählen, in der Sie den Import durchführen möchten.
- Wählen Sie das Symbol Weitere Optionen ⋮ und dann Importieren aus. Je nach Größe und Komplexität der Importdatei kann die Verarbeitung einige Sekunden bis mehrere Minuten dauern.
- Wählen Sie Datei auswählen und wählen Sie eine JSON-, CSV- oder XLSX-Datei zum Hochladen aus. Bei CSV-Dateien kann jeweils nur ein Organisationsdetail importiert werden, während der Import von Produkten nicht unterstützt wird. Die importierten Änderungen erscheinen so, als hätten Sie die Daten manuell bearbeitet.
- Wählen Sie Schließen aus.
- Wählen Ausstehende Änderungen überprüfen aus. Wählen Sie dann Änderungen übermitteln aus, um auszuführen. Vor dem Ausführen der Änderungen werden die ausstehenden Aktionen auf dieselbe Weise angezeigt wie bei manuellen Bearbeitungen in der Global Admin Console.
Schemata exportieren und importieren
Beim Importieren von Daten mithilfe einer CSV-Datei können die Felder in jeder beliebigen Reihenfolge angezeigt werden, müssen jedoch immer mit ihrer Kopfzeile übereinstimmen.
Beim Importieren von Daten müssen Sie für jedes Element einen Vorgang angeben. Der Vorgang kann einer der folgenden sein:
- Aktualisieren: zeigt eine Bearbeitung an.
- Erstellen: gibt das Erstellen eines neuen Objekts an (z. B. Organisation, Benutzergruppe oder Administrator).
- Löschen: gibt das Löschen eines Objekts an (z. B. Organisation, Benutzergruppe oder Administrator).
Eingabedateien ohne oder leeres Operationsfeld werden ignoriert.
Organisationen
Importanforderungen:
- Zum Aktualisieren oder Löschen muss orgId auf eine vorhandene Organisation in Ihrer Hierarchie verweisen.
- Wenn Sie eine neue Organisation erstellen, können Sie das Feld orgId leer lassen oder auf eine eindeutige ID festlegen, die Sie erstellen können (z. B. new-1 oder new-2). Diese ID kann verwendet werden, um auf die zu erstellende Organisation zu verweisen.
- Ländercode muss gültig sein.
- Die orgId für Update- und Delete-Vorgang sollte bereits in der Organisationshierarchie vorhanden sein.
- orgId, die als Löschen markiert ist, sollte nicht als übergeordnete orgId für Organisationen mit Aktualisieren oder Erstellen ausgewählt werden.
- Untergeordnete Organisationen derselben Ebene und desselben übergeordneten Elements sollten nicht dieselben orgNames haben.
- Zum Erstellen einer Organisation oder Aktualisieren eines Organisationsnamens darf der Name der Organisation nicht mit dem Namen eines vorhandenen untergeordneten Elements desselben übergeordneten Elements übereinstimmen.
Admins
Importanforderungen:
- orgId, email, adminType und userType müssen gültige Werte enthalten.
- countryCode muss gültig sein.
- Wenn der Benutzer bereits vorhanden ist und aktualisiert wird, muss der userType dem Benutzer entsprechen.
- Überprüfen Sie, ob in der Organisation doppelte E-Mail-Adressen vorhanden sind.
Produktprofile
Exporte und Importe von Produktprofilen bestehen aus zwei Teilen: den Produktprofildetails und einem Satz von Ressourcen, die mit dem Produktprofil verknüpft sind. Diese Ressourcen identifizieren Dienste, die konfiguriert werden können, in der Regel nur, um sie zu aktivieren oder zu deaktivieren.
- Die Ressourcenobjekte sind im Produktprofil im JSON-Format verschachtelt.
- Bei Verwendung von CSV oder XLSX mit Produktprofilen werden die Profile und Ressourcen zu einer Tabelle zusammengefasst. Für das Produktprofil sind mehrere Einträge vorhanden, einer für jede Ressource.
- Das ausgewählte Feld in der Ressource steuert, ob der Service aktiviert ist.
- Beim Importieren von Produktprofilen muss es einen Vorgang Erstellen oder Aktualisieren für das Produktprofil selbst und für alle Ressourcenobjekte geben, die aktualisiert oder erstellt werden sollen.
Importanforderungen:
-
productProfileId, licenseId und orgId müssen gültige Werte haben.
-
Beim Erstellen eines Produktprofils muss der productProfileName ein gültiger Name sein und darf keinen anderen Produktprofilnamen oder Benutzergruppennamen in derselben Organisation duplizieren.
-
Das Kontingentfeld muss einen gültigen Wert für den Einheitentyp haben. Dies ist numerisch oder unbegrenzt, wenn resourceType=QUOTA oder andernfalls leer ist.
-
Das Benachrichtigungsfeld muss „true“ oder „false“ sein.
-
Validieren Sie für CSV- und XLSX-Importe productProfileId. Alle Einträge müssen dieselbe orgId, licenseId und productProfileName aufweisen.
-
Überprüfen Sie doppelten productProfileName in der Eingabedatei und in der Organisation.
-
Profile, die aktualisiert und gelöscht werden sollen, müssen in der Organisation vorhanden sein.
-
Ressourcen, die aktualisiert und gelöscht (deaktiviert) werden sollen, müssen im Profil vorhanden sein.
-
Stellen Sie Folgendes sicher, damit Profile erstellt werden können:
- Die orgId sollte eine neue Organisation oder eine vorhandene Organisation sein.
- Die licenseId sollte ein neues oder ein vorhandenes Produkt sein.
- Überprüfen Sie die Ressourcen für das Profil.
Ressourcen in Produktprofilen
Importanforderungen:
- Das Vorgangsfeld für Ressourcen wird ignoriert, wenn für das Produktprofil, zu dem sie gehören, Vorgänge auf Löschen oder Erstellen eingestellt sind.
- Es sollte keine Ressource zum Löschen markiert werden; dies ist ein ungültiger Vorgang.
- Damit Produktprofile erstellt werden können, sollte die Anzahl der Ressourcen mit der Anzahl der Ressourcen des Quellproduktprofils übereinstimmen.
- Für Ressourcen mit Aktualisieren-Vorgang muss die Ressource im Produktprofil vorhanden sein.
Benutzergruppen
Importanforderungen:
-
orgId muss auf eine bestehende Organisation oder eine Organisation verweisen, die im selben Import erstellt wird.
-
userGroupId muss für die Aktualisierung oder Löschung auf eine vorhandene Gruppe verweisen und kann eine ID sein, die Sie für neue Benutzergruppen definieren.
-
Für die Aktualisierung oder Erstellung darf userGroupName nicht leer sein und darf keinen anderen Benutzergruppen- oder Produktprofilnamen in derselben Organisation duplizieren.
-
Stellen Sie sicher, dass userGroupName in der Eingabedatei und in der Organisation nicht dupliziert ist.
-
Zu aktualisierende und zu löschende Benutzergruppen müssen in der Organisation vorhanden sein.
-
Das Profil, das aus der Benutzergruppe entfernt werden soll, muss in der Benutzergruppe vorhanden sein. Aktualisierungsvorgänge können nicht für das Profil einer Benutzergruppe durchgeführt werden.
-
Stellen Sie Folgendes sicher, damit Benutzergruppen erstellt werden können:
- Die orgId sollte eine neue Organisation oder eine vorhandene Organisation sein.
- Die LicenseId sollte ggf. ein neues oder ein vorhandenes Produkt sein.
- Die productProfileId sollte ein neues Produktprofil oder ein vorhandenes Produktprofil sein.
Domains
Die Domain-Informationen enthalten schreibgeschützte Informationen zu den in den einzelnen Organisationen verfügbaren Domains. Diese Daten können nicht bearbeitet werden.
Produkte und Ressourcen products-and-resources
In XLSX-Dateien gibt es zwei Blätter - eine für Produkte und eine für die Ressourcen. In JSON werden Ressourcenobjekte im Produktobjekt verschachtelt.
Produkte
Importanforderungen:
- Für die Erstellung muss licenseId eine eindeutige ID sein, die Sie erstellen.
- Für die Aktualisierung muss licenseId die ID eines vorhandenen Produkts in der angegebenen Organisation sein.
- orgId muss auf eine vorhandene Organisation verweisen oder auf eine Organisation, die im selben Importvorgang erstellt wird.
- Für die Erstellung muss sourceLicenseId auf ein vorhandenes Produkt oder auf die ID verweisen, die Sie für ein Produkt definiert haben, das im selben Importvorgang erstellt wird.
- licenseId und sourceLicenseId sollten für Produkte mit dem Vorgang Erstellen nicht identisch sein.
- Validieren Sie die Organisationen von Produkten. Die Organisation sollte eine neue sein oder bereits in der Organisationshierarchie vorhanden sein.
- Für Vorgang Aktualisieren“ und Löschen sollte das Produkt bereits in der Organisationshierarchie vorhanden sein.
- licenseId, die als Löschen markiert ist, sollte nicht als sourceLicenseId von Produkten mit Erstellen und Aktualisieren verwendet werden.
- Überprüfen Sie bei Produkten mit Erstellen-Vorgang, ob die sourceLicenseId in der übergeordneten Organisation vorhanden sein muss.
Ressourcen für Produkte
Ressourcenobjekte können in Produkten und in Produktprofilen angezeigt werden.
Importanforderungen:
Das Feld Vorgang für Ressourcen wird ignoriert, wenn für das Produkt, zu dem sie gehören, Vorgänge auf Löschen oder Erstellen eingestellt sind.
- Es sollte keine Ressource zum Löschen markiert werden; dies ist ein ungültiger Vorgang.
- Für zu erstellende Produkte sollte die Anzahl der Ressourcen mit der Anzahl der Ressourcen des Quellprodukts übereinstimmen.
- Für Ressourcen mit Aktualisieren-Vorgang muss die Ressource im Produkt vorhanden sein.
Importieren und Exportieren von Produktzuordnungsdaten
Als globaler Administrator können Sie die Produktzuordnungsdaten als JSON- oder CSV-Datei exportieren. Anschließend können Sie diese Daten ändern und hochladen, um die Änderungen zu importieren. Beim Hochladen der potenziell geänderten Daten werden die neuen Daten mit den aktuellen Daten verglichen und alle Änderungen werden auf die Produktzuordnungsdaten angewendet. Sie können dann die ausstehenden Änderungen überprüfen und übermitteln, damit sie wirksam werden.
Exportieren des Produktzuordnungsmodells
Gehen Sie wie folgt vor, um das Produktzuordnungsmodell zu exportieren:
- Melden Sie sich bei der Global Admin Console an und navigieren Sie zur Registerkarte Produktzuordnung .
- Wählen Sie das ⋮ Weitere Optionen und dann CSV exportieren oder JSON exportieren. Ihre Datei wird heruntergeladen. Weitere Informationen über die Exportformate.
Produkt-Zuordnungsmodell importieren
Sie können Daten exportieren, ändern und dann die geänderte Datei importieren. Gehen Sie wie folgt vor, um das Produktzuordnungsmodell zu importieren:
- Melden Sie sich bei der Global Admin Console an und navigieren Sie zur Registerkarte Produktzuordnung .
- Wählen Sie das ⋮ Weitere Optionen und dann Importieren aus.
- JSON- oder CSV-Datei zum Hochladen auswählen.
- Wählen Ausstehende Änderungen überprüfen aus. Wählen Sie nach Überprüfung der Änderungen Änderungen übermitteln aus, um Änderungen .
Export- und Importformate für die Produktzuordnung
Die Export- und Importformate sind identisch. Beim Importieren im CSV-Format können die Felder in jeder beliebigen Reihenfolge angezeigt werden, sie müssen jedoch mit der Kopfzeile übereinstimmen. Beim Importieren im JSON-Format können die Felder in beliebiger Reihenfolge angezeigt werden.
Sie müssen den Vorgang beim Importieren von Produktzuordnungsdaten angeben. Der Vorgang kann einer der folgenden sein:
- Aktualisieren: zeigt eine Bearbeitung an (Änderung an „grantedQuantity“, „allowOverAllocation“-Werte).
- Erstellen: gibt an, dass der angegebenen Organisation eine Produktressource hinzugefügt werden soll.
- Löschen: gibt das Löschen des Produkts an.
Wenn kein -Vorgang angegeben ist, treten keine Änderungen auf, wenn Daten für diese Zeile in CSV oder das -Objekt in JSON importiert werden.
In der exportierten Datei gibt es eine Zeile oder einen Datensatz für jede Produktressource. Einige Produkte verfügen über mehr als eine Ressource.
Wenn ein Produkt mehr als eine Ressource hat, können Aktualisierungsvorgänge auf unabhängige Ressourcen angewendet werden, ein Löschvorgang löscht das Produkt einschließlich aller Ressourcen aus einer Organisation, und ein Erstellungsvorgang benötigt einen Datensatz für jede der Ressourcen in der Importdatei, damit die richtige Menge jeder dieser Ressourcen angegeben werden kann. Das Feld allowOverAllocation ist produktweit und es spielt keine Rolle, in welcher Ressource ein Update für dieses Feld vorhanden ist.
Beschreibung der Header
Einfuhrbestimmungen
Datenvalidierung
-
Das Vorgangsfeld muss einen gültigen Vorgang haben.
-
Die Produktimportdaten müssen über Eigenschaften und Werte für erforderliche Felder verfügen.
-
Die Eigenschaften der Produktimportdaten müssen vom richtigen Typ sein.
-
Das Produktrichtlinienfeld (overallocation) darf für verschiedene Ressourcen nicht angegeben werden.
-
Das Feld grantedQuantity:
- Kann nicht in "" geändert werden wenn es nicht bereits "".
- Muss eine nicht negative Ganzzahl oder der Zeichenfolgenwert (unlimited sein
Berechtigungs-/barrierefreie Validierung
- Die mit den Importdaten verknüpfte Organisation muss vorhanden sein. Stellen Sie bei einer Aktualisierung sicher, dass das mit den Importdaten verknüpfte Produkt und die Ressource tatsächlich vorhanden sind.
Produktvalidierung hinzufügen
- SourceLicenseId muss vorhanden sein.
- Die mit dem neuen Produkt verknüpfte Organisation muss vorhanden sein.
- Das erstellte Produkt darf nicht vorhanden sein (Produkt mit derselben Lizenz-ID).
- Die Ressourcen, die einem zu erstellenden Produkt zugeordnet sind, müssen über eine entsprechende productId verfügen, die mit diesem Produkt übereinstimmt.