Wichtig

Diese Importfunktion ist in unserem Dev-Branch verfügbar.

Arbeitspakete aus einer CSV-Datei importieren

Sie können mehrere Arbeitspakete gleichzeitig erstellen, indem Sie eine CSV-Datei hochladen. Bestehende Arbeitspakete werden durch einen Import niemals verändert, und es werden keine Benachrichtigungen zu den dabei erstellten Arbeitspaketen versendet.

Überblick

Thema	Inhalt
Bevor Sie beginnen	Die erforderliche Berechtigung und die Vorlage, mit der Sie beginnen können.
Datei importieren	Wie eine Datei zuerst überprüft und dann importiert wird.
Spaltenreferenz	Alle Spalten, die importiert werden können, sowie die Art und Weise, wie ihre Werte zugeordnet werden.
Limits	Wie groß eine Datei sein darf.
Was nicht importiert wird	Was der CSV-Import derzeit nicht abdeckt.

Bevor Sie beginnen

Hinweis

Sie benötigen die Berechtigung Arbeitspakete importieren, um Arbeitspakete in ein Projekt zu importieren. Sie kann in der Verwaltung unter Benutzer und Berechtigungen einer Rolle zugewiesen werden, zusammen mit der dafür erforderlichen Berechtigung Arbeitspakete hinzufügen.

Um die Importseite zu öffnen, rufen Sie das Modul Arbeitspakete in Ihrem Projekt auf, klicken Sie auf die grüne Schaltfläche + Erstellen oberhalb der Tabelle mit den Arbeitspaketen und wählen Sie Aus CSV importieren aus.

Beginnen Sie mit der Vorlage. Über den Link Vorlage herunterladen auf der Importseite erhalten Sie eine CSV-Datei mit genau den Spaltenüberschriften, die dieses Projekt akzeptiert, sowie zwei Beispielzeilen. Ersetzen Sie die Beispiele durch Ihre eigenen, behalten Sie die Kopfzeile bei und speichern Sie die Datei als CSV UTF-8.

Die Datei muss eine UTF-8- oder UTF-16-kodierte .csv-Datei sein. Komma, Semikolon und Tabulator werden alle als Trennzeichen akzeptiert, und das Trennzeichen wird aus der Kopfzeile ermittelt, sodass eine von einer Tabellenkalkulationsanwendung in einer beliebigen Ländereinstellung exportierte Datei unverändert hochgeladen werden kann. Ein Wert, der ein Trennzeichen, einen Zeilenumbruch oder ein Anführungszeichen enthält, muss in Anführungszeichen gesetzt werden; dies übernehmen Tabellenkalkulationsprogramme für Sie.

Datei importieren

1. Wählen Sie die Datei unter CSV-Datei aus.
2. Lassen Sie die Option „Datei zunächst prüfen, ohne sie zu importieren“ ausgewählt. Jede Zeile wird anschließend überprüft und protokolliert, es wird jedoch nichts angelegt.
3. Wählen Sie Datei prüfen aus.
4. Sehen Sie sich den Bericht an. Sollte die Datei Fehler enthalten, werden diese einzeln aufgeführt, einschließlich der Zeile, in der sie vorkommen, der Spalte, des Werts und der Art des Fehlers. Eine Datei mit vielen Problemen zeigt die ersten 500 auf der Seite; der CSV-Download neben der Liste enthält immer alle Dateien, so dass Sie sie in Ihrer Tabellenkalkulationsanwendung durcharbeiten können.“
5. Korrigieren Sie die Datei und überprüfen Sie sie erneut, bis der Bericht keine Probleme mehr anzeigt.
6. Klicken Sie auf die Schaltfläche Importieren, auf der angegeben ist, wie viele Arbeitspakete erstellt werden sollen, um diese zu erstellen.

Die nach einer erfolgreichen Überprüfung angezeigte Zusammenfassung gibt Auskunft darüber, wie viele Zeilen gelesen wurden, wie viele Konten in der Datei in den Spalten „Assignee“, „Accountable“ und „Author“ aufgeführt sind sowie welche Typen, Status, Prioritäten und Kategorien die Zeilen aufweisen. So können Sie sich vergewissern, dass die Datei genau so verstanden wurde, wie Sie es beabsichtigt haben, bevor irgendetwas angelegt wird.

Sobald der Import abgeschlossen ist, enthält der Bericht Verweise auf die dabei erstellten Arbeitspakete. Über den Link wird eine Ansicht mit dem Namen CSV-Import am Datum und zur Uhrzeit der Ausführung geöffnet, die privat für Sie gespeichert wird und die auch unter Ihren eigenen Ansichten in der Seitenleiste des Moduls „Arbeitspakete“ angezeigt wird. Löschen Sie sie wie jede andere Ansicht, sobald Sie sie nicht mehr benötigen.

Mit „Clear“ wird der Bericht gespeichert und das leere Formular an Sie zurückgegeben. Diese Option wird in jedem Status neben der Schaltfläche angezeigt, sodass ein Bericht, den Sie bereits fertiggestellt haben, oder eine Datei, die abgelehnt wurde, niemals auf der Seite verbleiben muss.

Tipp

Die überprüfte Datei wird einige Stunden lang gespeichert, sodass Sie sie beim Importieren nicht erneut hochladen müssen. Sollten Sie später auf den Bericht zurückkommen und die Datei ist bereits abgelaufen, laden Sie sie bitte erneut hoch. Es wird noch einmal überprüft, bevor etwas erstellt wird.

Sie können das Kontrollkästchen „Datei zuerst prüfen, ohne zu importieren“ deaktivieren, um den Import sofort durchzuführen. Auf der Schaltfläche steht dann Datei importieren, sodass stets deutlich wird, was geschehen wird.

Ein Import ist entweder vollständig oder gar nicht. Wenn eine Zeile nicht erstellt werden kann, wird gar nichts erstellt, und der Bericht listet alle Probleme in der Datei auf, anstatt bereits beim ersten Problem anzuhalten. Sie werden als Autor jedes Arbeitspakets erfasst, das durch den Import erstellt wird, es sei denn, in der Spalte „Autor“ ist eine andere Person angegeben.

Spaltenreferenz

Die Kopfzeile legt fest, was importiert wird. Die Reihenfolge der Spalten ist beliebig, und Sie benötigen nur die Spalten, die Sie ausfüllen möchten. Eine Kopfzeile, die nicht in der nachstehenden Tabelle aufgeführt ist, unterbricht den Import, noch bevor eine Zeile gelesen wird; dasselbe gilt, wenn dasselbe Attribut zweimal vorkommt.

Spalte	Inhalt	Erforderlich	Format und Zuordnung
Thema	Der Name des Arbeitspakets	Ja	Text
Beschreibung	Die Beschreibung	Nein	Text. Ein Wert, der Zeilenumbrüche enthält, muss in Anführungszeichen gesetzt werden.
Typ	Aufgabe, Meilenstein, Phase usw.	Nein	Der Vergleich erfolgt anhand des Namens, wobei Groß- und Kleinschreibung nicht berücksichtigt wird. Der Typ muss in diesem Projekt aktiviert sein.
Status	Der Status	Nein	Der Vergleich erfolgt anhand des Namens, wobei Groß- und Kleinschreibung nicht berücksichtigt wird. Der Status muss vorhanden sein.
Priorität	Die Priorität	Nein	Der Vergleich erfolgt anhand des Namens, wobei Groß- und Kleinschreibung nicht berücksichtigt wird. Die Priorität muss vorhanden und aktiv sein.
Kategorie	Die Kategorie	Nein	Der Vergleich erfolgt anhand des Namens, wobei Groß- und Kleinschreibung nicht berücksichtigt wird. Die Kategorie muss in diesem Projekt vorhanden sein.
Version	Die Version	Nein	Der Vergleich erfolgt anhand des Namens, wobei Groß- und Kleinschreibung nicht berücksichtigt wird. Die Version muss in diesem Projekt offen und verfügbar sein. In der Zelle wird nur eine Version unterstützt.
Zugewiesen an	Die zugewiesene Person	Nein	Der Abgleich erfolgt anhand der E-Mail-Adresse, mit der sich der Benutzer anmeldet, wobei Groß- und Kleinschreibung nicht berücksichtigt wird. Dem Benutzer muss die Berechtigung sein, in diesem Projekt Arbeitspakete zugewiesen zu bekommen.
Verantwortlich	Die verantwortliche Person	Nein	Die Zuordnung erfolgt auf dieselbe Weise wie bei „Zugewiesen an“.
Autor	Derjenige, der das Arbeitspaket erstellt hat	Nein	Anhand der E-Mail-Adresse abgeglichen. Lassen Sie das Feld leer oder lassen Sie die Spalte weg, dann werden Sie als Autor vermerkt.
Anfangstermin	Das Startdatum	Nein	JJJJ-MM-TT, zum Beispiel 2026-03-17.
Endtermin	Das Enddatum	Nein	JJJJ-MM-TT.
Aufwand	Der geschätzte Arbeitsaufwand	Nein	Stunden als Zahl, zum Beispiel „8“ oder „7,5“, oder als Zeitdauer, wie beispielsweise „1 h 30 min“.
Verbleibender Aufwand	Die noch zu erledigende Arbeit	Nein	Wird wie „Aufwand“ geschrieben. Nicht verfügbar, solange der Fortschritt anhand des Status berechnet wird.
% abgeschlossen	Der Fortschritt	Nein	Eine ganze Zahl zwischen 0 und 100, mit oder ohne Prozentzeichen. Nicht verfügbar, solange der Fortschritt anhand des Status berechnet wird.
Erstellt	Wenn das Arbeitspaket erstellt wurde	Nein	JJJJ-MM-TTTHH:MM:SSZ, zum Beispiel 2025-11-04T09:30:00Z. Kann nicht in der Zukunft liegen.
Aktualisiert am	Wenn es zuletzt aktualisiert wurde	Nein	JJJJ-MM-TTTHH:MM:SSZ. Kann nicht in der Zukunft liegen und nicht vor dem Datum Erstellt.

Ein Wert, der nicht übereinstimmt, wird zusammen mit der Zeile, in der er steht, gemeldet. Der Bericht listet die Werte auf, die akzeptiert worden wären, sodass ein falsch eingegebener Typ oder Status schnell korrigiert werden kann.

Erstelle und Aktualisiert am gibt es für Arbeitspakete, die von einem anderen System kommen und deren Daten behalten sollten. Erstellt bewegt auch den Erstellungseintrag in der Aktivität des Arbeitspakets, sodass sich eine Grundlinie (Planungsvergleich) über einen Zeitraum vor dem Import so verhält, wie es zu der Zeit gewesen wäre.

Hinweis

Die Spaltenüberschriften werden auch in der Sprache angezeigt, in der Sie OpenProject verwenden. Eine Datei, die mit deutschen Überschriften wie Thema und Zugewiesen an erstellt wurde, lässt sich importieren, solange Ihre Sprache auf Deutsch eingestellt ist. Es kann jedoch nicht garantiert werden, dass die Übersetzungen stabil sind; daher wird eine Datei, die in einer Version von OpenProject importiert wurde, möglicherweise in einer anderen Version nicht akzeptiert. Die englischen Überschriften in der obigen Tabelle funktionieren stets, unabhängig davon, welche Sprache eingestellt ist; aus diesem Grund werden sie in der zum Herunterladen bereitgestellten Vorlage verwendet.

Alles, was das Arbeitspaketformular ablehnen würde, wird auch hier Zeile für Zeile abgelehnt: ein fehlendes Thema, ein Enddatum vor dem Startdatum, ein Typ, für den es diesen Status im Workflow nicht gibt.

Eine leere Zelle bedeutet „nicht angegeben“, und das Arbeitspaket wird mit den Werten angelegt, die sich aus dem Projekt und dem Typ ergeben würden. In einer CSV-Datei gibt es keine Möglichkeit, einen Wert „explizit als leer“ zu kennzeichnen; daher kann ein standardmäßig festgelegter Wert nicht gelöscht werden, indem man die entsprechende Zelle leer lässt.

Limits

Eine Datei kann standardmäßig bis zu 5.000 Zeilen umfassen und eine Größe von bis zu 5 MB haben. Teilen Sie einen größeren Import auf mehrere Dateien auf. Auf der Importseite sind die für Ihre Instanz geltenden Beschränkungen aufgeführt.

Beide Grenzwerte sind konfigurierbar. Die Dateigrößenbeschränkung gilt für jeden Anhang, ; ein Administrator kann sie daher unter Administration, Dateien, Anhänge ändern. Die Zeilenbegrenzung ist nicht in der Verwaltung festgelegt: Sie wird für die Instanz über die Umgebungsvariable OPENPROJECT_WORK__PACKAGE__IMPORT__MAX__ROWS festgelegt, , wofür Zugriff auf den Server erforderlich ist, auf dem die Instanz ausgeführt wird.

Was nicht importiert wird

Durch einen CSV-Import werden Arbeitspakete erstellt. Derzeit führt es keine der folgenden Funktionen aus.

• Vorhandene Arbeitspakete ändern: Mit jeder Zeile wird ein neues Arbeitspaket erstellt. Es gibt keine Möglichkeit, eine bereits Arbeitspakete anzusprechen.
• Hierarchien erstellen: Übergeordnete und untergeordnete Arbeitspakete müssen nach dem Import festgelegt werden.
• Beziehungen erstellen: Vorgänger, Nachfolger und die anderen Beziehungstypen werden nicht gelesen.
• Benutzerdefinierte Felder ausfüllen: Es werden ausschließlich die oben aufgeführten Spalten akzeptiert.
• Beobachter oder Anhänge festlegen.
• Tabellenkalkulationsdateien lesen: Speichern Sie eine .xlsx- oder .ods-Datei zunächst als CSV-Datei.