Importieren von Organisationsdaten mithilfe des API-basierten Imports (nachfolgender Import) (Vorschau)

In diesem Artikel werden zwei Arten von Importen behandelt: vollständig und inkrementell. Diese Importe aktualisieren die Daten, die Sie beim Einrichten der Verbindung mit Viva Insights angegeben haben.

Informationen zu nachfolgenden Importen

Wenn Sie Daten in Viva Insights importieren, führen Sie entweder eine vollständige oder eine inkrementelle Aktualisierung durch. Wenn Sie Felder löschen möchten, können Sie dazu eine vollständige Aktualisierung verwenden.

Die benutzerdefinierte Export-App, die Sie unter Importieren von Organisationsdaten (erster Import) erstellt haben, zusammen mit der DescriptiveDataUploadApp, die wir auf GitHub erstellt haben, erleichtert die aktualisierungen, über die wir unten sprechen. Als kurze Zusammenfassung: Wenn DescriptiveDataUploadApp ausgeführt wird, werden Daten aus dem ZIP-Ordner abgerufen, den Sie von GitHub heruntergeladen haben. Dieser gezippte Ordner enthält die folgenden Dateien:

• data.csv, die die Felder enthält, die Sie importieren möchten.
• metadata.json, die Ihre Quellfelder Viva Insights Feldern zuordnet. Sie verwenden auch metadata.json, um Viva Insights zu informieren, ob Ihre Aktualisierung vollständig oder inkrementell ist, wie im nächsten Abschnitt erläutert.

Angeben einer vollständigen oder inkrementellen Aktualisierung

1. Wechseln Sie metadata.json zu Zeile 3.
2. Aktualisieren Sie die “IsBootstrap”: -Eigenschaft auf eine der folgenden Eigenschaften:
   • Verwenden Sie “IsBootstrap” : “true”für eine vollständige Aktualisierung .
   • Verwenden Sie “IsBootstrap” : “false”für eine inkrementelle Aktualisierung .

Wenn DescriptiveDataUploadApp ausgeführt wird, beginnt Viva Insights, Ihre Daten entweder als vollständige oder inkrementelle Aktualisierung zu verarbeiten, je nachdem, was Sie hier in metadata.json angegeben haben.

Aktualisierungstypen

Vollständig

Wenn Sie eine vollständige Aktualisierung durchführen, ersetzen Sie alle Daten Ihrer organization in Viva Insights, d. h., Sie überschreiben, was Sie bereits importiert haben. Wenn Sie eine vollständige Aktualisierung durchführen, stellen Sie sicher, dass Sie Daten für alle lizenzierten und nicht lizenzierten Mitarbeiter bereitstellen (d. h. diejenigen, die über ein Viva Insights-Abonnement verfügen, und für diejenigen, die dies nicht getan haben). Wir beschreiben weiter unten in diesem Artikel, welche Felder bereitgestellt werden sollen.

Sie können eine vollständige Aktualisierung verwenden, um Felder zu löschen, da Felder, die Sie weglassen, nicht in Ihren Daten angezeigt werden. Im nächsten Abschnitt wird das Löschen von Daten behandelt.

Löschen von Feldern mit vollständigen Aktualisierungen

Um Felder mit einer vollständigen Aktualisierung zu löschen, exportieren Sie Ihre Daten als .csv, die alle Felder mit Ausnahme der Felder enthält, die Sie löschen möchten. Da eine vollständige Aktualisierung vorhandene Daten ersetzt, erhalten Sie am Ende jedes Feld mit Ausnahme der Felder, die Sie beim Import ausgelassen haben.

Inkrementell

Führen Sie eine inkrementelle Aktualisierung durch, wenn Sie nur einige neue Informationen zu Organisationsdaten hinzufügen möchten, die Sie bereits in Viva Insights hochgeladen haben. So können Sie eine inkrementelle Aktualisierung ausführen:

• Hinzufügen neuer Mitarbeiter
• Hinzufügen neuer Attribute für vorhandene Mitarbeiter
• Hinzufügen neuer Attribute für neue Mitarbeiter
• Bearbeiten der Attribute vorhandener Mitarbeiter

Im Folgenden finden Sie einige Beispiele dafür, wann Sie eine inkrementelle Aktualisierung durchführen können:

Hinzufügen neuer Mitarbeiter

Angenommen, Sie möchten Fünf neue Mitarbeiter zu Ihren Organisationsdaten hinzufügen. Während des Imports würden Sie Folgendes einschließen:

• Fünf Zeilen, die neue Mitarbeiterdaten enthalten.
• Erforderliche Attribute: PersonId, ManagerId, Organization und EffectiveDate.
• Alle reservierten optionalen Felder (z. B. HireDate), die Sie bereits in Viva Insights importiert haben.

Nachdem der Import abgeschlossen ist, ist die einzige Änderung, die Sie bemerken würden, fünf neue Zeilen und deren Werte.

Hinzufügen eines neuen Attributs

Vielleicht möchten Sie für alle vorhandenen Mitarbeiter ein optionales reserviertes Attribut hinzufügen, das noch nicht in Ihren Daten enthalten war – sagen wir location. Wenn Sie Ihre Daten importieren, würden Sie nur location,PersonId und EffectiveDate mit aktuellen und historischen Werten für jeden Mitarbeiter in Ihre .csv-Datei einschließen. Nach Abschluss des Imports finden Sie die gleichen Daten wie zuvor, mit Ausnahme einer neuen Spalte für jeden Mitarbeiter, Standort.

Felder, die in data.csv für vollständige und inkrementelle Aktualisierungen eingeschlossen werden sollen

Fügen Sie für die unten aufgeführten Aktualisierungstypen die folgenden Felder in Ihre data.csv-Datei ein. Stellen Sie sicher, dass Sie:

• Formatieren Sie diese Felder gemäß unseren Richtlinien unter Vorbereiten von Organisationsdaten.
• Entfernen Sie alle Felder, die Sie nicht einschließen, aus Ihrer metadata.json-Datei.
• Behalten Sie sowohl die data.csv- als auch die metadata.json-Dateien in dem ZIP-Ordner bei, den Sie von GitHub heruntergeladen haben. Wenn Sie die DescriptiveDataUploadApp ausführen, geben Sie den ZIP-Ordnerpfad an. Viva Insights pullen dann Ihre Daten von diesem Speicherort.