Daten mithilfe einer Kickstart-Vorlage in Workfront importieren
Kickstarts sind speziell formatierte Excel-Arbeitsmappen, die Sie mit Daten füllen können, die Sie in Workfront importieren möchten. Adobe Workfront bietet eine Kickstart-Vorlage, die Sie dazu verwenden können, wie unter Kickstarts-Datenimportprogramm“.
Dieser Prozess ist in drei Hauptaufgaben unterteilt:
- Exportieren Sie zunächst eine Kickstart-Vorlage als Tabellendatei
- Zweitens füllen Sie die Tabelle mit Ihren Daten
- Schließlich importieren Sie die ausgefüllte Tabelle in Workfront
Jedes dieser Verfahren wird in der richtigen Reihenfolge in diesem Artikel beschrieben.
Zugriffsanforderungen
Sie müssen über folgenden Zugriff verfügen, um die Schritte in diesem Artikel ausführen zu können:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
---|---|
Adobe Workfront-Plan | Beliebig |
Adobe Workfront-Lizenz |
Neu: Standard oder Aktuell: Plan |
Konfigurationen der Zugriffsebene | Systemadministrator |
Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation zu Workfront.
Einschränkungen
Sie können mithilfe einer Kickstart-Vorlage eine große Anzahl von Objekten in Workfront importieren. Beachten Sie jedoch die folgenden Einschränkungen:
- Durch das Importieren von Daten auf diese Weise werden Informationen zu Datensätzen, die bereits in Workfront vorhanden sind, nicht aktualisiert.
- Sie können nur neue Datensätze und deren Informationen importieren.
- Importieren Sie maximal 2.000 Datensätze gleichzeitig, um sicherzustellen, dass beim Import keine Zeitüberschreitung auftritt
Kickstart-Vorlage als Tabellendatei exportieren
Wenn Sie eine Kickstart-Vorlage exportieren, erhalten Sie eine leere Excel-Kalkulationstabellen-Arbeitsmappe. Nachdem die Tabelle auf Ihren Computer heruntergeladen wurde, können Sie sie verwenden, um Ihre Informationen einzutragen und sie dann wieder in Workfront zu importieren.
Kickstart-Vorlage exportieren:
-
Klicken Sie auf das Hauptmenü-Symbol
-
Klicken Sie System > Daten importieren (Kickstarts).
-
Wählen Sie die Informationstypen aus, die Sie einbeziehen möchten.
Jede von Ihnen ausgewählte Option stellt eine Sammlung mehrerer Registerkarten im exportierten Arbeitsblatt dar. Wenn Sie beispielsweise die Option Bericht auswählen, werden alle erforderlichen Objekte zum Erstellen eines Berichts in die Tabelle aufgenommen (Ansichten, Filter, Gruppierungen, Berichte).
Sie können alle unten aufgeführten Objekttypen verwenden, um Daten in Workfront zu importieren. (Die einzige Ausnahme ist die Option Zugriffsebenen . Das Datenblatt „Zugriffsebenen“ in einem Export wird zu Referenzzwecken bereitgestellt - es ermöglicht Ihnen, einem neuen Benutzerkonto eine Zugriffsebene per ID zuzuweisen.)
Die Vorlage für jeden Objekttyp kann in den folgenden Dateiformaten exportiert werden und enthält die folgenden Blätter:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 layout-auto Objekt Exportiert als Tabellen in der exportierten Tabelle Dashboard
Alle Dashboards im System können exportiert werden. Sie können in einem Export bis zu 100 spezifische Dashboards auswählen.
Exportiert als ZIP-Datei Parameter
Beschreibender Text
Parameteroption
Parametergruppe
Kategorieparameter
Kategorie
Bericht
Portal-Registerkarten-Abschnitt
Dashboard
Einstellungen
Bericht
Alle Berichte im System können exportiert werden. Sie können bis zu 100 spezifische Berichte in einem Export auswählen.
Kickstarts unterstützen keine Textmodusfilter oder Gruppierungen. Für einen erfolgreichen Export müssen die Berichtsfilter und Gruppierungen in den Standardmodus umgeschaltet werden.
Exportiert als ZIP-Datei Parameter
Beschreibender Text
Parameteroption
Parametergruppe
Kategorieparameter
Kategorie
Bericht
Einstellungen
Genehmigung Exportiert als Excel-Datei Genehmigende Person für Phase
Genehmigungsphase
Genehmigung
Genehmigungsprozess
Einstellungen
Benutzerdefinierte Daten Exportiert als Excel-Datei Parameter
Beschreibender Text
Parameteroption
Parametergruppe
Kategorieparameter
Kategorie
Einstellungen
Ausgabentyp Exportiert als Excel-Datei Ausgabentyp
Einstellungen
Stundentyp Exportiert als Excel-Datei Stundentyp
Einstellungen
Team Exportiert als Excel-Datei Teammitglied
Team
Einstellungen
Benutzerin oder Benutzer Exportiert als Excel-Datei. Um die vollständige Liste der Optionen anzuzeigen, klicken Sie auf Weitere Optionen. Benutzerin oder Benutzer
Einstellungen
Zugriffsebene Exportiert als Excel-Datei Zugriffsebene
Einstellungen
Zuweisung Exportiert als Excel-Datei Zuweisung
Einstellungen
Firma Exportiert als Excel-Datei Firma
Einstellungen
E-Mail-Vorlage Exportiert als Excel-Datei E-Mail-Vorlage
Einstellungen
Ausgabe Exportiert als Excel-Datei Kosten“
Einstellungen
Externe Seite Exportiert als Excel-Datei Externe Seite
Einstellungen
Filter Exportiert als ZIP-Datei Filter
Einstellungen
Gruppe Exportiert als Excel-Datei Gruppe
Einstellungen
Gruppierung Exportiert als ZIP-Datei Gruppierung
Einstellungen
Stunde Exportiert als Excel-Datei Stunde
Einstellungen
Problem Exportiert als Excel-Datei Problem
Einstellungen
Aufgabengebiet Exportiert als Excel-Datei Aufgabengebiet
Einstellungen
Meilensteinpfad Exportiert als Excel-Datei Meilenstein
Meilensteinpfad
Einstellungen
Notiz Exportiert als Excel-Datei Notiz
Einstellungen
Portfolio Exportiert als Excel-Datei Portfolio
Einstellungen
Projekt Exportiert als Excel-Datei Warteschlange
Projekt
Routingregel
Warteschlangenthema
Einstellungen
Ressourcenkalkulation Exportiert als Excel-Datei Ressourcenkalkulation
Einstellungen
Risiko Exportiert als Excel-Datei Risiko
Einstellungen
Risikotyp Exportiert als Excel-Datei Risikotyp
Einstellungen
Scorecard Exportiert als Excel-Datei Scorecard-Frage
Scorecard-Option
Scorecard
Einstellungen
Aufgabe Exportiert als Excel-Datei Aufgabe
Einstellungen
Vorlage Exportiert als Excel-Datei Warteschlange
Vorlage
Routingregel
Warteschlangenthema
Einstellungen
Vorlagenzuweisung Exportiert als Excel-Datei Vorlagenzuweisung
Einstellungen
Vorlagenaufgabe Exportiert als Excel-Datei Vorlagenaufgabe
Einstellungen
Arbeitszeittabelle Exportiert als Excel-Datei Arbeitszeittabellen-Profil
Arbeitszeittabelle
Einstellungen
Anzeigen Exportiert als ZIP-Datei Anzeigen
Einstellungen
-
Klicken Sie Herunterladen.
-
Fahren Sie mit Kalkulationstabellenvorlage mit Ihren Daten füllen fort, um die leere Vorlagenkalkulationstabelle mit Ihren Informationen zu füllen.
Füllen Sie die Tabellenvorlage mit Ihren Daten populate-the-spreadsheet-template-with-your-data
Übersicht über die in der Tabelle enthaltenen Registerkarten (Datenblätter)
Wenn Sie eine leere Kick-Starts-Vorlage öffnen, stehen eine Reihe von Registerkarten (Datenblätter) zur Verfügung. Sie hängen von den Objekten ab, die Sie zum Herunterladen ausgewählt haben. Jede Komponente stellt ein Objekt in der Anwendung dar, z. B. Projekt, Aufgaben, Stunden, Dashboard und Benutzer:
Wenn Sie eine dieser Registerkarten öffnen, zeigt Zeile 2 die Felder für jedes Objekt an, das während eines Imports festgelegt werden kann. In einer Spaltenüberschrift wird nach dem Wort „set“ der Name des Felds so angezeigt, wie er in der Datenbank angezeigt wird. Diese Felder dienen als Spaltenüberschriften.
- Löschen Sie nicht die leere erste Zeile einer Kickstart-Tabelle.
- Diese Felder (Spaltenüberschriften) dürfen in keiner Weise gelöscht, geändert oder neu angeordnet werden. Ändern Sie beispielsweise weder ihre Reihenfolge noch ihren Namen.
- Fügen Sie Werte zu jedem Feld hinzu, das in der Spaltenüberschrift fett dargestellt wird. Diese stellen Pflichtfelder dar.
- Bestimmte Felder, einschließlich setResourceRevenue und setEnteredByID, werden automatisch vom System generiert. Wenn Sie Daten für diese Felder in das Arbeitsblatt eingeben, wird der Kickstart-Prozess diese Daten beim Hochladen des Arbeitsblatts überschreiben.
Datensatz importieren import-a-record
Jede Zeile des Blatts entspricht einem eindeutigen Objekt.
-
Fügen Sie Informationen in der Spalte isNew hinzu:
-
Wenn das zu importierende Objekt neu ist, geben Sie TRUE ein, um die Daten in die Zeile zu importieren. Bei diesem Wert wird zwischen Groß- und Kleinschreibung unterschieden. Er muss immer in Großbuchstaben geschrieben werden
-
Wenn sich das Objekt bereits in Workfront befindet, geben Sie FALSE in die Spalte isNew ein, um die Zeile zu ignorieren. Bei diesem Wert wird zwischen Groß- und Kleinschreibung unterschieden. Er muss immer in Großbuchstaben geschrieben werden
- Datensätze, die bereits in Workfront vorhanden sind, werden nicht aktualisiert.
- Wenn Sie eine Vorlage mit Daten aus Workfront heruntergeladen haben, sind vorhandene Objekte bereits mit "".
- Wenn Sie eine leere Vorlage heruntergeladen haben, müssen Sie keine neuen Zeilen für vorhandene Objekte hinzufügen.
-
-
Fügen Sie Informationen in der Spalte ID auf eine der folgenden Arten hinzu:
-
Wenn das zu importierende Objekt neu ist (und Sie „TRUE in der Spalte isNew eingegeben haben), geben Sie eine beliebige Zahl für die ID ein. Diese Zahl muss in der Tabelle eindeutig sein. Wenn Sie beispielsweise drei Objekte importieren, können Sie ihnen die ID 1, 2 bzw. 3 zuweisen.
-
Wenn das Objekt bereits in Workfront vorhanden ist (und FALSE sich in der Spalte isNew befindet) und Sie neue Informationen über vorhandene Objekte importieren, muss die ID die alphanumerische GUID sein, die in Workfront für dieses Objekt vorhanden ist.
note tip TIP Um die eindeutige GUID eines Objekts in Workfront zu ermitteln, können Sie einen Bericht für dieses Objekt erstellen und die ID-Spalte zum Bericht hinzufügen. Der Wert für jedes Objekt in dieser Spalte ist die GUID des -Objekts. - Datensätze, die bereits in Workfront vorhanden sind, werden nicht aktualisiert.
- Wenn Sie eine Vorlage mit Daten heruntergeladen haben, enthalten vorhandene Objekte bereits die GUID als ID.
- Sie können ein neues Objekt importieren, das auf einem vorhandenen Objekt basiert, indem Sie FALSE in der Spalte isNew in TRUE ändern, die ID ändern und vor dem Import die erforderlichen Datenanpassungen vornehmen.
-
Beim Importieren eines Projekts müssen Sie eine Gruppen-ID angeben.
- Wenn die Gruppe bereits in Workfront vorhanden ist, müssen Sie ihre eindeutige ID zum Feld setGroupID für das Projekt hinzufügen.
- Wenn die Gruppe in Workfront nicht vorhanden ist, können Sie das Blatt GROUP zu Ihrer Importdatei hinzufügen, das Feld isNew auf TRUE auf dem Gruppenblatt festlegen und in der Spalte ID eine numerische ID für die neue Gruppe angeben. Das Feld setGroupID für das neue Projekt muss mit der numerischen ID für die neue Gruppe übereinstimmen.
Beispiel Für ein Projekt muss der in der Spalte setGroupID angezeigte Wert einer der folgenden sein:
- Die GUID für eine bestehende Gruppe in Ihrer Workfront-Instanz
- Der Wert (Zahl) in der Spalte ID auf dem Blatt Gruppe, wenn Sie beim Import eine neue Gruppe erstellen
-
-
Geben Sie Werte für die erforderlichen Felder und alle anderen Felder ein, die Sie während des Imports ausfüllen möchten.
-
(Optional) So fügen Sie benutzerdefinierte Daten hinzu:
-
Erstellen Sie für jedes benutzerdefinierte Feld, das Sie in den Importprozess einbeziehen möchten, eine neue Spalte.
-
Benennen Sie jede neue Spalte für das entsprechende benutzerdefinierte Feld wie folgt: DE:[Name des benutzerdefinierten Felds, wie es in Workfront angezeigt wird]. Sie können beispielsweise das folgende benutzerdefinierte Feld erstellen: „DE: Departments“.
-
Geben Sie in die Spalte setCategoryID die GUID des vorhandenen benutzerdefinierten Formulars ein, in dem sich dieses benutzerdefinierte Feld befindet. Dieses Feld ist beim Import von benutzerdefinierten Daten erforderlich.
-
Wenn Sie mehrere Datenwerte in dem benutzerdefinierten Feld hinzufügen müssen (z. B. Optionsfelder, Kontrollkästchen oder Listen), verwenden Sie das vertikale Balken-Trennzeichen für benutzerdefinierte Daten "|", das auf der Registerkarte „Voreinstellungen“ aufgeführt ist, um die Werte zu trennen.
Beispiel: Geben Sie A|D unter der Spalte DE:Departments ein, um Abteilung A und Abteilung D in Ihrem benutzerdefinierten Formular auszufüllen.
-
Daten einschließen include-dates
Workfront kann die meisten Datumsformate verarbeiten. Sie müssen jedoch sicherstellen, dass die Datumsspalte in der Tabelle als Datum formatiert ist. Der Import schlägt fehl, wenn die Spalte als Allgemein, Zahl oder Text formatiert ist.
Workfront akzeptiert auch Zeitwerte als Teil des Datums.
Beispiel: 07/10/2022 13:30 oder 07/10/2022 13:00 Uhr.
Wenn Sie eine Uhrzeit im Datum auslassen, führt Workfront einen der folgenden Schritte aus:
- Angenommen, die Zeit ist um 00:00 Uhr. Um das erwartete Datumsergebnis sehen zu können, muss die Systemzeitzone mit Ihrer Zeitzone übereinstimmen.
- Wenn er sich auf einem Objekt befindet, das mit einem Zeitplan verknüpft ist, bezieht sich die Zeit auf die früheste Zeit, die der Zeitplan zulässt.
Platzhalter verwenden use-wildcards
Sie können beim Ausfüllen Ihrer Kickstart-Vorlage die folgenden Platzhalter verwenden:
Bei Verwendung in einem setDate-Feld legt dieser Platzhalter das Datum als Mitternacht am Tag des Kickstarts fest.
Sie können den Platzhalter mit der Standardsyntax ändern, die mit dem Platzhalter für einen Filter zulässig ist.
Beispiel: Wenn ein Projekt am Montag der Woche starten soll, an der es importiert wird, können Sie $$TODAYbw verwenden, unabhängig davon, an welchem Tag Sie den Import tatsächlich durchführen. Damit wird das geplante Startdatum Ihres Projekts auf Sonntag, 12:00 Uhr festgelegt. Da der Zeitplan für das Projekt zu diesem Zeitpunkt wahrscheinlich keine Arbeit zulässt, wird es um 9:00 Uhr Montagmorgen beginnen.
Bei Verwendung in einem setDate-Feld legt dieser Platzhalter das Datum entsprechend dem Zeitpunkt fest, zu dem Sie den Datensatz während des Kickstart-Imports erstellen.
Sie können den Platzhalter mit der Standardsyntax ändern, die mit dem Platzhalter für einen Filter zulässig ist.
Beispiel: Wenn ein Projekt 3 Stunden nach dem Import gestartet werden soll, können Sie $$NOW+3h verwenden.
Dieser Platzhalter wurde speziell für Kickstart-Benutzerimporte hinzugefügt. Beim Erstellen eines Workfront-Kontos wird ein Benutzer mit der Zugriffsebene „Systemadministrator“ erstellt. Der dem Standardadministrator zugewiesene Benutzername kann beim Erstellen anderer Benutzer im Konto als Präfix verwendet werden.
Da Benutzernamen für alle Kunden eindeutig sein müssen, ist dies nützlich, wenn Sie mehrere Personen mit sehr gängigen Benutzernamen wie John Smith haben, die möglicherweise den Benutzernamen „jsmith“ haben. Indem Sie der Benutzernamenzuweisung den standardmäßigen Administrator-Benutzernamen voranstellen, garantieren Sie, dass jeder Benutzername eindeutig ist (z. B.: $$CUSTOMER.jsmith).
Tipp: Eine elegantere Methode, um sicherzustellen, dass Benutzernamen systemweit eindeutig sind, besteht darin, die E-Mail-Adresse des Kontakts in das Feld setUsername einzugeben.
Ersetzung von IDs durch Attributnamen attribute-name-substitution-for-ids
Obwohl es sich als Best Practice empfiehlt, nach Möglichkeit immer IDs zu verwenden, ist es manchmal unpraktisch, IDs von einem Blatt zum anderen zu vergleichen, wenn ein Wert setAttributeID festgelegt wird. Sie können Werte anhand des Namens referenzieren, indem Sie einfach die Spaltenüberschrift ändern.
Beispiele:
-
Projektimport
Legen Sie beim Importieren von Projekten die setGroupID der Projekte fest, indem Sie zum Blatt GROUP wechseln, die entsprechenden Gruppen-IDs notieren und sie in die richtigen Zellen (Spalte setGroupID) in das Blatt PROJ Project einfügen.
Dies ist möglich, wenn Sie nur mit wenigen Gruppen und Projekten arbeiten, aber wenn Sie mit mehreren von jedem arbeiten, ist dies nicht praktisch.
Um die Ersetzung durch den Attributnamen für das oben beschriebene Beispiel durchzuführen, ändern Sie die Spaltenüberschrift setGroupID in #setGroupIDGRUPPENNAME. Sie können dann nach Namen auf die Gruppe der einzelnen Projekte verweisen.
note note NOTE Die Option zur Verwendung der Attributnamensersetzung ist auf Verweise für vorhandene Datensätze beschränkt. Sie können keine Namensersetzung für Objekte verwenden, die Sie im selben Import erstellen. -
Benutzerimport
Füllen Sie beim Importieren von Benutzenden setRoleID auf der Registerkarte ROLE aus einer Liste von Rollen aus.
Einige der Rollen-IDs sind für Datensätze vorgesehen, die bereits im Konto vorhanden sind, andere werden während des Imports erstellt.
Für neue Benutzerdatensätze, die vorhandenen Rollen zugewiesen sind, können Sie die Namensersetzung verwenden. Für die neuen Benutzerdatensätze, die neu importierten Rollen zugewiesen wurden, ist dies nicht möglich.
So können Sie beide Methoden für dieselbe Importdatei verwenden:
-
Fügen Sie in der Tabelle links neben der Spalte setRoleID“ eine Spalte.
-
Benennen Sie die neue Spalte mit dem Namen {0#setRoleIDROLE .
-
Für Rollenzuweisungen zu vorhandenen Datensätzen geben Sie die Rollennamen in die Spalte #setRoleID ein.
Für Rollenzuweisungen zu neuen Rollendatensätzen geben Sie die ID ein, die Sie auf dem Funktionsblatt in der setRoleID zugewiesen haben.
-
Importieren der Tabellendaten in Workfront
Nachdem Sie die Excel-Vorlage mit Ihren Daten gefüllt haben, können Sie deren Daten in Workfront hochladen.
Der Kickstart-Import unterstützt die folgenden Dateitypen:
-
Excel (.xls oder .xlsx)
-
ZIP-Datei (die nur XLSX- oder XLS-Dateien enthält)
note note NOTE Sie müssen beim Importieren von Excel-Tabellen, die auf die folgenden Objekte verweisen, eine ZIP-Datei verwenden: - Berichte
- Dokumente
- Avatare
- Anzeigen, Filtern oder Gruppieren von Eigenschaftendateien
Bei Verwendung einer komprimierten Importdatei muss die ZIP-Datei denselben Namen haben wie die XLSX- oder XLS-Datei, und alle Dateien müssen sich auf derselben Strukturebene befinden (keine Ordner).
So importieren Sie die Tabellenkalkulationsvorlagendaten in Workfront:
-
Klicken Sie auf das Hauptmenü-Symbol
-
Klicken Sie System > Daten importieren (Kickstarts).
-
Klicken Sie Abschnitt Daten mit Kickstart- hochladen auf Datei auswählen navigieren Sie dann zu und wählen Sie das ausgefüllte Arbeitsblatt aus.
-
Klicken Sie auf Hochladen.
Wenn das Hochladen der Excel-Datei in Workfront länger als 5 Minuten dauert, tritt ein Timeout der Anwendung auf, und Workfront kann die Datei nicht hochladen.
Importieren Sie Ihre Daten in kleinere Objektstapel.
-
(Bedingt) Wenn Sie Workfront Fusion verwenden, können Sie jetzt Ihre FLOs oder Szenarien aktivieren.