Wie kann ich Umfragen über eine CSV-Datei duplizieren oder aktualisieren?

Mit dem Umfrage-Import können Umfragen neu erstellt und aktualisiert sowie Empfänger automatisch hinzugefügt und entfernt werden.

​

Honestly-Server

Hostname: import.honestly.com Port: 22 Zielordner: /upload/ (das Hauptverzeichnis ist schreibgeschützt) Zielpfad: /upload/surveys.csv Benutzername: import-surveys-<account-id> Du musst <account-id> nicht bei uns erfragen. Honestly setzt den Wert für dich ein: Im Fenster CSV Umfragenimport findest du den vollständigen Benutzernamen unter SFTP Username und den Server unter SFTP Hostname, jeweils mit einer Schaltfläche, die den Wert in die Zwischenablage kopiert. Dies ist eine Beispielansicht eines internen Accounts:

​

Datei in den Ordner upload hochladen

Nach der Anmeldung siehst du im Hauptverzeichnis / nur den Ordner upload. Das Hauptverzeichnis ist schreibgeschützt: Die Datei muss direkt in den Ordner upload, nicht ins Hauptverzeichnis und nicht in einen Unterordner. Vollständiger Zielpfad: /upload/surveys.csv

• WinSCP oder ein anderes SFTP-Programm: Wechsle nach der Anmeldung zuerst in den Ordner upload und ziehe die Datei erst dann hinein.
• Skript oder automatische Übertragung: Setze den Zielpfad auf /upload/surveys.csv.

​

Authentifizierung

Die Authentifizierung erfolgt passwortlos (SSH-Key-Authentifizierung). Bitte generiere einen öffentlichen Schlüssel und hinterlege ihn bei der Einrichtung der Umfrage-Import-Integration. Der öffentliche Schlüssel muss im OpenSSH-Format vorliegen — eine einzelne Zeile, die mit dem Schlüsseltyp beginnt, zum Beispiel ssh-ed25519 oder ssh-rsa. Ed25519-, ECDSA- und RSA-Schlüssel werden akzeptiert; wir empfehlen Ed25519. Beispiel für eine Public-Key-Datei

​

CSV-Datei

Der Dateiname muss surveys.csv lauten. Die Datei muss mit dem Zeichensatz UTF-8 ohne BOM codiert sein. Die Daten müssen durch ein Komma getrennt und in doppelte Anführungszeichen eingeschlossen werden. Die erste Zeile der Datei muss die Spaltennamen enthalten. Die Reihenfolge spielt keine Rolle.

​

Erforderliche Spalten

Die folgenden Spalten müssen in der CSV-Datei enthalten sein – auch die, deren Werte leer bleiben dürfen.

​

Bestehende Umfragen aktualisieren

Findet der Import eine bestehende Umfrage – zuerst über die ImportId, sonst über den SurveyName –, legt er keine neue an. Stattdessen aktualisiert er genau drei Dinge: den Willkommenstext, die Empfänger und die Berechtigungen. Abschlusstext, E-Mail-Betreff und -Text, Erinnerungen, Zeitplan, Status und Datumsangaben bleiben unverändert. Willkommenstext Der Willkommenstext wird bei jedem Import neu gesetzt – ob die Spalte WelcomeMessage gefüllt ist oder nicht:

• WelcomeMessage leer: Jede Sprache der Umfrage erhält den aktuellen Willkommenstext der Vorlage, aus der die Umfrage erstellt wurde, in genau dieser Sprache. Sprachen, die die Umfrage selbst nicht hat, kommen nicht hinzu.
• WelcomeMessage gefüllt: Derselbe Text wird in alle Sprachen der Umfrage geschrieben.

Maßgeblich ist die Vorlage, mit der die Umfrage verknüpft ist – nicht der Wert in ReusedSurveyTemplateName. Ist eine Umfrage mit keiner Vorlage verknüpft, bleibt ihr Willkommenstext bei leerer WelcomeMessage unverändert, und die Admins erhalten nach dem Import eine E-Mail mit einem entsprechenden Hinweis. Empfänger und Berechtigungen Mitarbeitende, deren Import-ID neu in der Datei steht, werden hinzugefügt. Entfernt werden nur Empfänger und Berechtigungen, die über den Import verwaltet werden – also solche, die ein früherer Import hinzugefügt hat oder die in einer früheren Datei aufgeführt waren. Manuell hinzugefügte bleiben erhalten. Beispiel: Neuen Willkommenstext der Vorlage in viele Umfragen übernehmen Du hast den Willkommenstext deiner Vorlage überarbeitet und in alle Sprachen übersetzt, und alle daraus erstellten Umfragen sollen ihn bekommen. Lege dafür eine surveys.csv mit einer Zeile pro Umfrage an: ImportId und SurveyName der bestehenden Umfrage, eine leere WelcomeMessage und in den Empfänger- und Berechtigungsspalten die aktuellen Import-IDs. Nach dem nächsten Import hat jede Umfrage in jeder ihrer Sprachen den neuen Text der Vorlage.

​

Optionale zusätzliche Umfrage-Eigenschaften

Abhängig von der Konfiguration der Umfrage-Eigenschaften in der Web-Anwendung können zusätzliche Umfragedaten übergeben werden, um detailliertere Auswertungen zu erhalten. Dazu muss die CSV-Datei um diese zusätzlichen Spalten im String-Format erweitert werden. Der Spaltenname muss dem Namen der Umfrage-Eigenschaft entsprechen. Jeder Wert darf höchstens 100 Zeichen lang sein. Die Eigenschaften werden beim Anlegen einer Umfrage gesetzt und bei bestehenden Umfragen nicht geändert. In der Web-Anwendung kann der Nutzer auswählen, welche Umfragedaten tatsächlich als Filter im Dashboard angezeigt werden sollen.

​

Weitere Bedingungen

• Wird die angegebene Umfragevorlage nicht gefunden, wird keine Umfrage erstellt
• Werden Spalten, die nicht leer sein dürfen, leer gelassen, wird die Umfrage nicht erstellt oder aktualisiert
• Empfänger und Berechtigungen werden für archivierte und aktive Umfragen gleichermaßen aktualisiert
• Bei bestehenden Umfragen werden nur Willkommenstext, Empfänger und Berechtigungen aktualisiert (siehe Abschnitt „Bestehende Umfragen aktualisieren“ oben)

​

Import-Ablauf

Regeln für das Aktivierungsdatum: Wöchentlich:

1. Aktivierungsdatum in der Vergangenheit
   1. Die Umfrage wird in den nächsten Minuten aktiviert und versendet, sobald die Umfrage geöffnet ist
   2. Ist der Zeitplan deiner Vorlage bereits abgelaufen, wird die Umfrage in der folgenden Woche versendet
2. Aktivierungsdatum in der aktuellen Woche
   1. Die Umfrage wird in den nächsten Minuten aktiviert und versendet, sobald die Umfrage geöffnet ist
   2. Ist der Zeitplan deiner Vorlage bereits abgelaufen, wird die Umfrage in der folgenden Woche versendet
3. Aktivierungsdatum in der Zukunft
   1. Die Umfrage wird genau an dem über die Spalte „activation date“ übermittelten Datum geöffnet
   2. Ist der Zeitplan deiner Vorlage zu diesem Zeitpunkt bereits abgelaufen, wird die Umfrage in der folgenden Woche versendet

Zweiwöchentlich:

1. Aktivierungsdatum in der Vergangenheit
   1. Die Umfrage wird in den nächsten Minuten aktiviert, jedoch nur, wenn die Umfrage in dieselbe Woche wie die aktuelle fällt
   2. Ist der Zeitplan deiner Vorlage bereits abgelaufen, wird die Umfrage in 2 Wochen versendet
   3. Beispiel: Du hast die Umfrage für Woche 1 aktiviert, es ist aber bereits Woche 2 – dann wird die Umfrage in Woche 3 versendet
2. Aktivierungsdatum in der aktuellen Woche
   1. Die Umfrage wird in den nächsten Minuten aktiviert
   2. Ist der Zeitplan deiner Vorlage bereits abgelaufen, wird die Umfrage in 2 Wochen versendet
3. Aktivierungsdatum in der Zukunft
   1. Die Umfrage wird genau an dem über die Spalte „activation date“ übermittelten Datum geöffnet
   2. Ist der Zeitplan deiner Vorlage zu diesem Zeitpunkt bereits abgelaufen, wird die Umfrage in 2 Wochen versendet

Monatlich:

1. Aktivierungsdatum in der Vergangenheit
   1. Die Umfrage wird in den nächsten Minuten aktiviert und versendet, sobald die Umfrage geöffnet ist
   2. Ist der Zeitplan deiner Vorlage bereits abgelaufen, wird die Umfrage im nächsten Monat versendet
2. Aktivierungsdatum im aktuellen Monat
   1. Die Umfrage wird in den nächsten Minuten aktiviert und versendet, sobald die Umfrage geöffnet ist
   2. Ist der Zeitplan deiner Vorlage zu diesem Zeitpunkt bereits abgelaufen, wird die Umfrage im folgenden Monat versendet
3. Aktivierungsdatum in der Zukunft
   1. Die Umfrage wird genau an dem über die Spalte „activation date“ übermittelten Datum geöffnet
   2. Ist der Zeitplan deiner Vorlage zu diesem Zeitpunkt bereits abgelaufen, wird die Umfrage im nächsten Monat versendet

Einmalige Umfragen:

1. Ich habe eine Umfrage mit einem Aktivierungsdatum von heute erstellt
   1. Die Umfrage wird in den nächsten Minuten aktiviert
2. Aktivierungsdatum in der Zukunft
   1. Die Umfrage wird genau an dem über die Spalte „activation date“ übermittelten Datum geöffnet

Integrationshinweis: Sobald die Integration eingerichtet ist, werden die Umfragedaten automatisch täglich um 4:15 Uhr und 16:15 Uhr importiert.

​

Verwandte Artikel

• Wie synchronisiere ich meine Mitarbeiterdaten mit meinem HR System?
• Wie erstelle ich eine neue Umfrage?
• Was ist die Empfängerliste (Distribution), wie funktioniert diese im Detail und was passiert wenn ich diese entferne?
• Wie kann ich meine bestehenden Umfragen verwalten und welche Informationen kann ich einsehen?
• Welche Richtlinien musst du für einen erfolgreichen Excel-Import befolgen?