Kickstart-Szenario: Importieren von benutzerdefinierten Feldern mit mehreren Optionen in Workfront

Klicken Sie auf das Hauptmenü-Symbol in der oberen rechten Ecke von Adobe Workfront oder (falls verfügbar) klicken Sie auf das Hauptmenü-Symbol in der oberen linken Ecke und klicken Sie dann auf ​ ​Setup .

Erweitern Sie System im linken Menü und klicken Sie dann auf Daten exportieren (Kickstarts).

Wählen Benutzerdefinierte Daten im Abschnitt Was eingeschlossen werden soll aus.

Wählen Sie im Abschnitt Download-Format die Datei .xlsx.

Klicken Sie Herunterladen. Eine XLSX-Datei wird auf Ihren Computer heruntergeladen. Navigieren Sie dazu und öffnen Sie sie.

Überprüfen Sie die heruntergeladene Datei und beachten Sie die folgenden Details:

• Die Datei enthält mehrere Blätter. Möglicherweise benötigen Sie nicht die Informationen in jedem Blatt, aber Sie verwenden einige der Blätter, um Ihre Informationen zu importieren. Nehmen Sie sich etwas Zeit, um sich mit deren Inhalt und insbesondere mit dem Format des Inhalts in jedem Blatt vertraut zu machen.
• Achten Sie besonders auf die Spaltennamen und auf das Format, in dem die Daten in jeder Spalte angezeigt werden.
• Sie dürfen die Namen oder die Reihenfolge der Spalten in keinem der Blätter ändern. Die Spaltenüberschriften geben in jeder Zeile die Felder an, die Sie mit Ihren Informationen ausfüllen müssen. Wenn die Spaltenüberschrift fett gedruckt ist, ist dies ein Pflichtfeld, sodass Sie Informationen in dieser Spalte haben müssen.

• Behalten Sie die heruntergeladene Datei als Referenz bei und fahren Sie mit dem folgenden Abschnitt fort.

Klicken Sie auf das Hauptmenü-Symbol in der oberen rechten Ecke von Adobe Workfront oder (falls verfügbar) klicken Sie auf das Hauptmenü-Symbol in der oberen linken Ecke und klicken Sie dann auf ​ ​Setup .

Erweitern Sie System im linken Menü.

Klicken Sie Daten importieren (Kickstarts).

Aktivieren im Bereich „Leeres Kickstart-Arbeitsblatt herunterladen das Kontrollkästchen Benutzerdefinierte Daten und klicken Sie auf Herunterladen.

Eine leere Kickstart-Datei wird auf Ihren Computer heruntergeladen.

Öffnen Sie das Excel-Arbeitsblatt, das Sie im vorherigen Abschnitt heruntergeladen haben, und überprüfen Sie die Arbeitsblätter. Jedes Blatt stellt ein Objekt in der Anwendung dar.

Beispiel: Parameter (verweist auf benutzerdefiniertes Feld), Parameteroption (verweist auf die Option für benutzerdefiniertes Feld), Kategorie (verweist auf benutzerdefiniertes Formular).

Sie müssen die Namen der Objekte und deren Attribute in dem von der Workfront-Datenbank unterstützten Format schreiben.

Informationen zur Bedeutung dieser Objekte finden Sie im Glossar der Adobe Workfront Terminologie.

Informationen zu den Namen der Objekte in der Workfront-Datenbank finden Sie unter API-Explorer.

Stellen Sie sicher, dass die folgenden Informationen korrekt formatiert sind:

• Die erste Zeile jedes Blatts muss leer bleiben, da der Import sonst einen Fehler erzeugt.

• Die Spaltenüberschriften in jedem Blatt stellen Attribute der Objekte dar, die während eines Imports festgelegt werden können. Alle Spaltenüberschriften müssen in der gleichen Reihenfolge bleiben, in der Sie sie beim Exportieren des Blatts finden, und sie können nicht umbenannt werden.

• Die fett gedruckten Spaltenüberschriften sind Pflichtfelder und müssen einen Wert enthalten.

  note tip
  TIP
  Einige Spalten sind erforderlich, obwohl sie nicht fett formatiert sind. Die Spalten isNew und ID sind beispielsweise nicht fett gedruckt, sondern Pflichtfelder.

Wählen Sie das **PARAM Parameter**-Blatt aus und fügen Sie Informationen zu den neuen benutzerdefinierten Feldern in den folgenden erforderlichen Spalten hinzu:

• isNew = Geben Sie TRUE in dieser Spalte für jede Zeile ein, die ein neues benutzerdefiniertes Feld darstellt. Dies bedeutet, dass das Feld neu ist und nicht in Workfront vorhanden ist.

  note tip
  TIP
  Wenn eine Zeile ein bereits in Workfront vorhandenes Feld darstellt, geben Sie isNew = FALSE ein.

• ID = muss für jede Zeile, die ein neues Feld darstellt, eine eindeutige Zahl sein. Sie können eine beliebige Zahl verwenden, die mit 1 beginnt, sofern jedes neue Feld über eine eindeutige Zahl verfügt.

• setDataType = Geben Sie für jede Zeile, die ein neues Feld darstellt, den vom Feld unterstützten Datentyp ein. Der Datentyp muss so eingegeben werden, wie er in der Datenbank angezeigt wird. Wählen Sie aus den folgenden Datentypen:

  • NMBR für Zahl
  • CURC für Währung
  • TEXT für Text

• **setDisplaySize**= Die Anzeigegröße ('setDisplaySize') für mehrere benutzerdefinierte Felder mit Optionen ist immer 0.

• setDisplayType = Geben Sie für jede Zeile, die ein neues Feld darstellt, den Anzeigetyp des Felds ein. Der Anzeigetyp muss so eingegeben werden, wie er in der Datenbank erscheinen würde.

  Wählen Sie für benutzerdefinierte Felder mit mehreren Optionen aus den folgenden Optionen aus:

  • MULT für Mehrfachauswahl-Dropdown
  • SLCT für Dropdown
  • RDIO für Optionsfelder
  • CHCK für Kontrollkästchen

  note tip
  TIP
  Informationen zum Datentyp und Anzeigetyp finden Sie im API-Explorer, erweitern Sie das Objekt Parameter und suchen Sie auf der Registerkarte Felder nach diesen Attributen.

• setName = Geben Sie den Namen der benutzerdefinierten Felder ein, wie er in Workfront angezeigt werden soll.

  note info
  INFO
  Beispielsweise können wir zwei benutzerdefinierte Felder importieren, Marke ein Kontrollkästchen und Medien ein Optionsfeld.

• Die Spalten setName und setValue enthalten in der Regel dieselben Informationen und sollten die Namen widerspiegeln, die in der Workfront-Benutzeroberfläche für Ihr neues Feld gewünscht werden.

Der Wert eines Felds ist beispielsweise der Name, der in Berichten angezeigt wird, während der Name in den benutzerdefinierten Formularen angezeigt wird, die an -Objekte angehängt sind.

Weitere Informationen finden Sie unter Erstellen eines benutzerdefinierten Formulars.

Wählen Sie das POPT Parameter Options aus und fügen Sie Informationen zu den Optionen der einzelnen benutzerdefinierten Felder in den folgenden erforderlichen Spalten hinzu:

• isNew = Geben Sie TRUE in dieser Spalte für jede Zeile ein, die eine neue Feldoption darstellt.

  note tip
  TIP
  Wenn eine Zeile eine vorhandene Option darstellt, geben Sie isNew = FALSE ein.

• ID = muss eine eindeutige Zahl für jede Zeile sein, die eine neue Option darstellt. Sie können eine beliebige Zahl verwenden, die mit 1 beginnt, sofern jede neue Option über eine eindeutige Zahl verfügt.

• setIsDefault = Geben Sie TRUE für die Optionen ein, die Sie standardmäßig anzeigen möchten, und FALSE Sie für alle anderen Optionen für jedes Feld ein. Beispielsweise möchten wir, Nike die Standardoption für Marke und Print die Standardoption für Media ist.

  note tip
  TIP
  Pro Feld kann nur eine Standardoption ausgewählt werden.

• setParameterID = die Optionen, die dem benutzerdefinierten Feld Marke entsprechen, haben einen setParameterID von 1, und die Optionen, die dem Media entsprechen, haben einen setParameterID ​von 2. Die PARAM- und POPT-Blätter verweisen einander, um anzugeben, welche Optionen zu welchem benutzerdefinierten Feld gehören.

• setDisplayOrder= Die Spalte Anzeigereihenfolge gibt die Reihenfolge an, in der die Optionen in Ihrem benutzerdefinierten Feld angezeigt werden. Sie können mit 1 beginnen und für alle Optionen in aufsteigender Reihenfolge fortfahren, unabhängig davon, zu welchen Feldern sie gehören. Wichtig ist hier, dass für jede Option eindeutige Zahlen vorhanden sind.

• Die Spalten setLabel und **setValue** enthalten in der Regel dieselben Informationen und sollten die gewünschten Namen in der Workfront-Benutzeroberfläche widerspiegeln. Der Wert einer Option ist beispielsweise der Name, der in Berichten angezeigt wird, während die Beschriftung in den benutzerdefinierten Formularen angezeigt wird, wenn sie an ein Objekt angehängt wird. Weitere Informationen finden Sie unter Erstellen eines benutzerdefinierten Formulars.

• setIsHidden = Geben Sie TRUE ein, wenn eine der Optionen ausgeblendet werden soll.

(Optional) Wenn Sie auch ein benutzerdefiniertes Formular erstellen möchten, in dem Sie später die neuen Felder hinzufügen können, wählen Sie das CTGY Category aus und aktualisieren Sie die folgenden erforderlichen Spalten für die Informationen des benutzerdefinierten Formulars:

• isNew = Geben Sie TRUE in dieser Spalte für jede Zeile ein, die ein neues benutzerdefiniertes Formular darstellt.
• ID = Geben Sie für jede Zeile, die für ein neues Formular steht, eine eindeutige Zahl ein. Sie können eine beliebige Zahl verwenden, die mit 1 beginnt, sofern jede neue Option oder Zeile über eine eindeutige Zahl verfügt.
• setGroupID = Fügen Sie die Gruppen-ID für Ihre Hauptgruppe oder eine andere Gruppe im System hinzu, deren Mitglieder Sie auf dieses Formular zugreifen möchten. Dies ist ein Pflichtfeld.

Um die ID einer Gruppe zu ermitteln, können Sie entweder einen Gruppenbericht erstellen und das Feld ID in der Ansicht hinzufügen oder zu einer Gruppe navigieren und die URL für die Gruppe suchen. Die Gruppen-ID befindet sich in der URL der Gruppenseite. Wenn beispielsweise die URL der Gruppe https://companyName.my.workfront.com/group/575b000800467a6f66e747932c807464/members ist, wird die Gruppen-ID 575b000800467a6f66e747932c807464.

• setCatObjCode= Dies ist der Objekt-Code für den Objekttyp, für den Sie das Formular erstellen möchten. Geben Sie einen Code aus den folgenden Optionen ein:

  • CMPY für Firma
  • Aufgabe TASK
  • PROJ für Projekt
  • PORT für Portfolio
  • PRGM für Programm
  • USER für Benutzer
  • DOCU für Dokument
  • OPTASK für Anfrage
  • EXPNS
  • ITRN für Iteration
  • BILL für Rechnungsnachweise
  • GROUP für Gruppe

  note note
  NOTE
  Geben Sie für Formulare mit mehreren Objekten das erste Objekt ein, das Sie beim Erstellen eines Formulars in der Benutzeroberfläche auswählen würden. Legen Sie beispielsweise den setCatObjCode auf TASK fest, wenn Sie in der Workfront-Benutzeroberfläche zunächst die Option „Aufgabe“ und dann „Problem“, "Portfolio" usw. auswählen, das Formular jedoch nicht für Projekte verfügbar sein soll.

• setName = Dies ist der Name des benutzerdefinierten Formulars, wie er in der Benutzeroberfläche von Workfront angezeigt werden soll.

  

Speichern Sie die Tabelle als XLS- oder XLSX-Datei auf Ihrem Computer. Ihre Excel-Tabelle ist ausgefüllt und kann jetzt in Workfront importiert werden.

Klicken Sie auf das Hauptmenü-Symbol in der oberen rechten Ecke von Adobe Workfront oder (falls verfügbar) klicken Sie auf das Hauptmenü-Symbol in der oberen linken Ecke und klicken Sie dann auf ​ ​Setup .

Klicken Sie System > Daten importieren (Kickstarts).

Klicken Sie Datei auswählen unter dem Abschnitt Daten mit Kickstart-Arbeitsblatt hochladen.

Suchen Sie die von Ihnen vorbereitete Excel-Tabelle auf Ihrem Computer und wählen Sie sie aus, wenn Sie sie finden.

Die Datei wird automatisch hochgeladen, und es wird eine Benachrichtigung angezeigt, dass der Import erfolgreich war. Je nachdem, wie viele Informationen Sie importieren, kann dieser Schritt einige Sekunden bis eine Minute dauern.

Die neuen benutzerdefinierten Felder und Formulare befinden sich nun in Ihrem Workfront-System. Sie finden sie im Bereich „Benutzerdefinierte Forms" unter „Setup“.

Informationen zum Hinzufügen von Feldern zu benutzerdefinierten Formularen finden Sie unter Erstellen eines benutzerdefinierten Formulars.

(Bedingt) Wenn der Import nicht erfolgreich war, erhalten Sie eine Fehlermeldung, die Sie über das Problem informiert. Versuchen Sie, das Feld, das Blatt und die Zeilennummer zu identifizieren, in der das Problem aufgetreten ist, und korrigieren Sie die Informationen in der Excel-Datei. Versuchen Sie dann erneut, die Datei zu importieren.

(Bedingt) Je nachdem, was das Problem ist, werden, wie in der Fehlermeldung angegeben, möglicherweise bereits einige Informationen importiert. Sie müssen einen der folgenden Schritte ausführen, bevor Sie das Blatt erneut importieren können:

• Löschen Sie die Informationen, die erfolgreich aus Workfront importiert wurden, aus dem Bereich Benutzerdefinierter Forms und nehmen Sie dann die in der Fehlermeldung angegebene Korrektur vor.
• Geben Sie an, dass für die bereits importierten Felder oder Formulare ein Feld oder ein Formular bereits im System vorhanden ist, und korrigieren Sie.
  Wenn Sie angeben möchten, dass ein Feld oder ein benutzerdefiniertes Formular bereits in Workfront vorhanden ist, müssen Sie sicherstellen, dass das inNew Feld in Plänen, die Informationen zum Formular (CTGY) oder zum Feld (PARAM) im Kickstart-Importblatt enthalten, als FALSE markiert ist.