Eingangskonnektor für Organisationshierarchie
Eingangskonnektor für Organisationshierarchie
Mit Organisationshierarchien können Sie Ihre Organisationsstruktur in XM Discover hochladen, um Datenanalysen, Benutzerpersonalisierung und Datenzugriffskontrolle zu verbessern. Sie können den eingehenden Konnektor für Organisationshierarchien verwenden, um Organisationshierarchien hochzuladen und zu aktualisieren.
Vorbereiten einer Organisationshierarchiedatei
Bevor Sie einen Eingangsjob für eine Organisationshierarchie einrichten können, müssen Sie sicherstellen, dass Ihre Organisationshierarchiedaten das richtige Format aufweisen und Ihre Organisationsstruktur enthalten.
Organisationshierarchien können mithilfe einer CSV- oder Excel-Datei (XLS oder XLSX) hochgeladen werden.
Beispiele und Formatierungsrichtlinien für jeden Dateityp finden Sie in den Best Practices für Organisationshierarchien.
Eingangsjob für Organisationshierarchie einrichten
Führen Sie die folgenden Schritte aus, um einen Eingangsjob für eine Organisationshierarchie einzurichten. Bei dieser Einrichtung müssen Sie ein Hierarchie-API-Token in Studio generieren. Dies wird empfohlen, bevor Sie die folgenden Schritte ausführen.
- Klicken Sie auf der Registerkarte Jobs auf Neuer Job.
- Wählen Sie Organisationshierarchie.
- Geben Sie Ihrem Job einen Namen, damit Sie ihn identifizieren können.
- Wählen Sie das Projekt aus, in das Daten geladen werden sollen.
- Geben Sie Ihrer Stelle eine Beschreibung, damit Sie ihren Zweck kennen.
- Klicken Sie auf Weiter.
- Wählen Sie ein SFTP-Konto aus, das Sie verwenden möchten, oder wählen Sie Neu hinzufügen, um ein neues Konto hinzuzufügen.
- Wenn Sie ein neues Konto hinzufügen, geben Sie die folgenden Informationen für Ihr SFTP-Konto ein:
- Verbindungsname: Geben Sie der Verbindung einen Namen, damit Sie sie später wiedererkennen können.
- SFTP-Benutzername: Geben Sie den Benutzernamen für die Verbindung mit Ihrem SFTP-Server ein.
- SFTP-Kennwort: Geben Sie das Kennwort für die Verbindung mit Ihrem SFTP-Server ein.
- SFTP-Host: Geben Sie die Host-URL Ihres SFTP-Servers ein.
- SFTP-Port: Geben Sie Ihren SFTP-Port ein. In der Regel ist dies 22.
- Ablaufbenachrichtigungen senden: Wenn Ihre SFTP-Anmeldeinformationen nach einer bestimmten Zeit ablaufen sollen, wählen Sie diese Option aus.
- Tage vor Ablauf: Wenn Sie Ablaufbenachrichtigungen aktivieren, geben Sie an, wie viele Tage Sie vor dem Ablauf benachrichtigt werden möchten. Sie können einen Wert zwischen 1 und 100 Tagen eingeben.
- Ablaufdatum: Legen Sie das Datum fest, an dem die Anmeldeinformationen ablaufen. Klicken Sie auf das Feld, um einen Kalender zum Auswählen des Datums zu öffnen.
- Klicken Sie auf Weiter.
- Geben Sie Ihre Hierarchie-API-Token.
- Klicken Sie auf Weiter.
- Geben Sie Ihrer Organisationshierarchie einen Namen.
- Wählen Sie aus, ob Sie Ihre Organisationshierarchie veröffentlichen möchten:
- Organisationshierarchie hochladen: Legen Sie eine Organisationshierarchie an, und aktivieren Sie sie. Standardmäßig ist die Veröffentlichung der aktivierten Organisationshierarchie rückgängig gemacht und ermöglicht nur die Dashboard-Personalisierung.
- Organisationshierarchie hochladen und veröffentlichen: Eine Organisationshierarchie anlegen, aktivieren und veröffentlichen. Durch die Veröffentlichung einer Organisationshierarchie können Sie Daten nach ihren Ebenen gruppieren. Dies ist eine Voraussetzung für das Peer- und Parent-Reporting sowie das Ziel- und Abweichungs-Reporting.
Tipp: Durch die Veröffentlichung einer Organisationshierarchie wird ein verborgenes entsprechendes Kategoriemodell erstellt, um zusätzliche Anwendungsfälle zu unterstützen. Das angelegte Kategoriemodell spiegelt die Struktur und die Filter der Organisationshierarchie wider und verhält sich gegebenenfalls wie ein Modell.
- Wählen Sie abhängig von Ihren Einstellungen zusätzliche Hierarchieoptionen aus:
- Gruppen basierend auf dieser Benutzerdatei generieren: Erstellen Sie Gruppen basierend auf der Organisationshierarchiedatei.
- Datensätze ohne Text einschließen: Nehmen Sie Datensätze mit leeren Verben in Ihre Organisationshierarchie auf. Diese Option ist nur verfügbar, wenn Sie Ihre Organisationshierarchie veröffentlichen.
- In inkrementellen Datenflüssen einschließen: Schließen Sie die Organisationshierarchie in inkrementelle Datenflussläufe ein. Diese Option ist nur verfügbar, wenn Sie Ihre Organisationshierarchie veröffentlichen.
Tipp: Wenn Sie erwarten, dass die Veröffentlichung einer Organisationshierarchie mit anderen Datenflüssen in Konflikt steht, empfehlen wir, diese Option zu deaktivieren. Das Modell, das angelegt und anschließend klassifiziert wird, blockiert keine anderen Datenflüsse, wenn diese Option deaktiviert ist.
- Klicken Sie auf Weiter.
- Wählen Sie den Dateityp aus, den Sie hochladen möchten:
- Durch Trennzeichen getrennte flache Dateien
- Excel-Dateien (XLS, XLSX)
- Für trennzeichengetrennte Flatfiles stehen Ihnen zusätzliche Einstellungen zur Auswahl:
- Dateikodierung: Wählen Sie das Kodierungssystem der Datei (UTF-8, ASCII usw.)
- Trennzeichen: Geben Sie das Zeichen ein, das zum Abgrenzen von Dateneinträgen verwendet wird. Standardmäßig ist dies ein Komma für CSV-Dateien.
- Umschließungszeichen: Geben Sie das Zeichen ein, das die Dateneingabe umschließt. Lassen Sie dieses Feld leer, wenn „Keine Einschließung“ ausgewählt ist.
- Kein Einschluss: Aktivieren Sie diese Option, wenn Ihre Datei keine Umschließungszeichen enthält.
- Klicken Sie auf Durchsuchen, und wählen Sie den Ordnerpfad auf Ihrem SFTP-Server aus, der die Datei enthält, die Sie hochladen möchten.
- Geben Sie den regulären Dateinamenausdruck ein, der mit den hochzuladenden Dateien übereinstimmt.
- Wenn Ihre Dateien komprimiert sind, aktivieren Sie Datei(en) entpacken, und geben Sie den regulären Ausdruck ZIP-Dateiname ein, der mit den Dateien übereinstimmt, die dekomprimiert werden sollen.
- Wenn Ihre Dateien entschlüsselt werden, aktivieren Sie Datei(en) entschlüsseln, und geben Sie Folgendes ein:
- Regulärer Ausdruck des verschlüsselten Dateinamens: Geben Sie den regulären Dateinamenausdruck für Dateien ein, die entschlüsselt werden sollen.
- PGP/GPG-Schlüssel: Geben Sie den PGP/GPG-Schlüssel ein, der für die Verschlüsselung verwendet wird.
- Kennphrase: Geben Sie die Kennphrase für die Entschlüsselung ein.
- Wenn Ihre Dateien sowohl komprimiert als auch verschlüsselt sind, müssen Sie zuerst auswählen, was passieren soll:
- Entpacken und dann Entschlüsseln: Dateien werden dekomprimiert und dann entschlüsselt.
- Entschlüsseln und entpacken: Dateien werden entschlüsselt und dann dekomprimiert.
- Sie müssen eine Beispieldatei bereitstellen, die entweder auf Ihrem Computer oder auf Ihrem SFTP-Server gespeichert werden kann:
- Wählen Sie Beispiel aus Dateiablage herunterladen, wenn die Beispieldatei auf Ihrem SFTP-Server gespeichert ist.
- Wählen Sie Stichprobe von meinem Computer hochladen, wenn die Probe auf Ihrem Computer gespeichert wird.
Tipp: Bei Bedarf können Sie eine Vorlagendatei herunterladen, indem Sie auf den Link hier klicken, der in der Jobeinrichtung angezeigt wird.
- Standardmäßig wird Ihre Beispieldatei nicht zum Generieren der Organisationshierarchie verwendet. Wenn Ihre Beispieldatei für den ersten Joblauf verwendet werden soll, aktivieren Sie Hochgeladene Beispieldatei für initialen Joblauf verwenden.
- Klicken Sie auf die Schaltfläche Datei auswählen, und wählen Sie die Beispieldatei auf Ihrem Computer oder auf Ihrem SFTP-Server aus.
- Eine Vorschau der Datei wird angezeigt. Wenn anstelle der Vorschau eine Fehlermeldung oder ein Rohdateiinhalt angezeigt wird, kann es zu Problemen mit den von Ihnen ausgewählten Datenformatoptionen kommen. Hilfe bei der Fehlerbehebung bei Ihrer Datei finden Sie unter Beispieldateifehler.
- Klicken Sie auf Weiter.
- Beginnen Sie mit der Zuordnung von Feldern aus Ihrer Beispieldatei zu Organisationshierarchiefeldern in XM Discover. Klicken Sie auf das Feld in der Spalte Zuordnung, um ein Feld für die XM-Discover-Organisationshierarchie auszuwählen, das Ihrem importierten Feld zugeordnet werden soll. Zu den möglichen Organisationshierarchiefeldern gehören:
- Ebene 1 bis Ebene 10: Definieren Sie die Struktur Ihrer Hierarchie. Die maximale Anzahl der Hierarchieebenen beträgt 10.
- Benutzer: Ordnen Sie die Benutzer Ihrer Hierarchie zu.
- Filter: Definieren Sie die Filter für Ihre Hierarchie.
- Anreicherungen: Erstellen Sie Anreicherungsparameter für Ihre Hierarchie. Die maximale Anzahl der Anreicherungen beträgt 6.
- Bei Bedarf können Sie eingehende Daten transformieren, indem Sie in der Spalte Transformationen auf das Zahnradsymbol klicken.
- Sie können zusätzliche Felder hinzufügen, indem Sie auf das Pluszeichen (+) klicken, oder Felder entfernen, indem Sie auf das Minuszeichen (– ) im Anhang des Felds klicken.
- Klicken Sie auf Weiter, wenn Sie die Zuordnung der Felder abgeschlossen haben.
- Wählen Sie Ihre Benachrichtigungseinstellungen.
- Klicken Sie auf Weiter.
- Wählen Sie Inkrementelle Läufe einplanen, wenn Ihr Job periodisch nach einem Zeitplan ausgeführt werden soll, oder Einmaligen Pull einrichten, wenn der Job nur einmal ausgeführt werden soll. Weitere Informationen finden Sie unter Jobeinplanung.
- Wählen Sie einen Aufbewahrungszeitraum für verarbeitete Dateien. Dateien werden nach dem festgelegten Zeitraum gelöscht.
- Klicken Sie auf Weiter.
- Überprüfen Sie Ihre Einrichtung. Wenn Sie eine bestimmte Einstellung ändern müssen, klicken Sie auf die Schaltfläche Bearbeiten, um zu diesem Schritt in der Verbindungseinrichtung zu gelangen.
- Wählen Sie Fertigstellen, um den Job zu sichern.