カスタムデータ用のキックスタートテンプレートを書き出し
システム内の既存のカスタムフィールドに関する情報をスキャンした後、読み込みに使う新しいキックスタートテンプレートをダウンロードします。
-
Adobe Workfront の右上隅にある メインメニュー アイコン
-
左側のメニューで システム を展開します。
-
「データを読み込み(キックスタート)」をクリックします。
-
空白の Kick-Start スプレッドシートをダウンロードする 領域で、「カスタムデータ」チェックボックスを選択し、ダウンロード をクリックします。
空のキックスタートファイルがお使いのコンピューターにダウンロードされます。
NOTE
ファイル内のシート数、名前、各シート内の列の数および列の名前を、上記の節でダウンロードした既存のカスタムデータを含むキックスタートのものと同じにする必要があります。
キックスタートの Excel スプレッドシートにデータを入力
Excel スプレッドシートに入力する前に、前述の節で説明したようにキックスタートテンプレートをダウンロードします。
Excel スプレッドシートに新しいカスタムフィールドの情報を入力するには、以下を実行します。
-
前の項でダウンロードした Excel スプレッドシートを開き、シートがいくつか表示されていることを確認します。各シートは、アプリケーション内の 1 つのオブジェクトを表します。
INFO
例えば、パラメーター(カスタムフィールドを指します)、パラメーターオプション(カスタムフィールドオプションを指します)、カテゴリ(カスタムフォームを指します)です。オブジェクトの名前と属性は、Workfront データベースでサポートされている形式で記述する必要があります。これらのオブジェクトの意味については、 Adobe Workfront の用語集を参照してください。Workfront データベース内のオブジェクトの名前について詳しくは、API エクスプローラーを参照してください。 -
次の情報が正しくフォーマットされていることを確認します。
-
すべてのシートの最初の行は空のままにする必要があります。空の場合は、インポートによってエラーが発生します。
-
各シートの列見出しは、インポート時に設定できるオブジェクトの属性を表します。すべての列ヘッダーは、シートを書き出すときに見つかった順序のままである必要があり、名前を変更することはできません。
-
太字の列ヘッダーは必須フィールドで、値を持つ必要があります。
TIP
一部の列は太字ではありませんが、必須です。例えば、isNew
およびID
列は太字ではありませんが、必須フィールドです。
-
-
**PARAM Parameter
** シートを選択し、次の必須列に新しいカスタムフィールドに関する情報を追加します。-
isNew
= には、新しいカスタムフィールドを表す各行のこの列にTRUE
を入力します。これは、フィールドが新しいもので、Workfront に存在しないことを示します。TIP
行が既に Workfront にある既存のフィールドを表す場合は、isNew
=FALSE
を入力します。 -
ID
= は、新しいフィールドを表す各行の一意の数値である必要があります。各新しいフィールドに一意の番号が含まれている限り、1 から始まる任意の数字を使用できます。 -
setDataType
= は、新しいフィールドを表す各行に対する設定で、フィールドがサポートするデータタイプを入力します。データタイプは、データベースに表示されるとおりに入力する必要があります。次のデータタイプから選択します。- 数字の場合
NMBR
- 通貨の場合
CURC
- テキストの場合
TEXT
- 数字の場合
-
**setDisplaySize**
= 表示サイズ(「setDisplaySize」)は、任意の複数のオプションのカスタムフィールドに対する設定で、常に 0 になります。 -
setDisplayType
= は、新しいフィールドを表す各行に対する設定で、フィールドの表示タイプを入力します。表示タイプは、データベースに表示されるとおりに入力する必要があります。複数オプションのカスタムフィールドの場合は、次のオプションから選択します。
- 複数選択ドロップダウンの場合
MULT
- ドロップダウン場合、
SLCT
- ラジオボタンの場合、
RDIO
- チェックボックスの場合、
CHCK
TIP
データタイプおよび表示タイプの情報を見つけるには、「API エクスプローラー」を参照して、パラメーター オブジェクトを展開し、「フィールド」タブでこれらの属性を探します。 - 複数選択ドロップダウンの場合
-
setName
= には、Workfront で表示するカスタムフィールドの名前を入力します。INFO
例えば、「ブランド」というチェックボックスフィールドと「メディア」というラジオボタンフィールドの 2 つのカスタムフィールドをインポートする場合があります。 -
setName
列とsetValue
列には通常、同じ情報が含まれており、Workfront インターフェイスで新しいフィールドに必要な名前が反映されている必要があります。
フィールドの値は、例えばレポートに表示される名前ですが、オブジェクトに添付されたカスタムフォームには名前が表示されます。
詳しくは、 カスタムフォームの作成を参照してください。
-
-
POPT Parameter Options
** シートを選択し、次の必須列に各カスタムフィールドのオプションに関する情報を追加します。-
isNew
= には、新しいフィールドオプションを表す各行のこの列のTRUE
を入力します。TIP
行が既存のオプションを表す場合は、isNew
=FALSE
を入力します。 -
ID
= は、新しいオプションを表す各行の一意の数値である必要があります。各新しいオプションに一意の番号が含まれている限り、1 から始まる任意の数字を使用できます。 -
setIsDefault
= には、各フィールドに、デフォルトで表示するオプションにはTRUE
を入力し、他のすべてのオプションにはFALSE
を入力します。例えば、「Nike」を「ブランド」のデフォルトオプションにし、「Print」を「メディア」のデフォルトオプションにします。TIP
各フィールドに指定できるデフォルトのオプションは 1 つだけです。 -
setParameterID
= 「ブランド」カスタムフィールドに対応するオプションのsetParameterID
は 1 で、「メディア」に対応するオプションのsetParameterID
は 2 です。PARAM
およびPOPT
シートは相互に参照され、どのオプションがどのカスタムフィールドに属しているかを示します。 -
setDisplayOrder
= 表示順列は、カスタムフィールドでオプションが表示される順序を示します。どのフィールドに属するかに関係なく、1 から始めて、すべてのオプションを昇順で続行できます。ここで重要なのは、各オプションに一意の数字を設定することです。 -
「
setLabel
」および「**setValue
**」列には通常同じ情報が含まれ、Workfront UI で必要な名前が反映されている必要があります。オプションの値は、例えばレポートに表示される名前です。ラベルはオブジェクトへの添付時にカスタムフォームに表示されます。詳しくは、 カスタムフォームの作成を参照してください。 -
setIsHidden
には、いずれかのオプションを非表示にする場合、「TRUE
」を入力します。
-
-
(オプション)後で新しいフィールドを追加するためのカスタムフォームも作成する場合は、「
CTGY Category
」シートを選択し、カスタムフォームの情報に関する次の必須列を追加して更新します。isNew
には、新しいカスタムフォームを表す各行のこの列に「TRUE
」を入力します。ID
には、新しいフォームを表す各行に一意の番号を入力します。1 から始まる任意の数字を使用できますが、新しいオプション(行)の番号がそれぞれ一意である必要があります。setGroupID
には、自分のホームグループ、またはこのフォームにアクセスするメンバーが属するシステム内の他のグループのグループ ID を追加します。必須フィールドです。
グループの
ID
を見つけるには、グループレポートを作成し、ビューでID
フィールドを追加するか、グループに移動してそのグループの URL を探します。グループ ID は、グループのページの URL に含まれています。例えば、グループの URL がhttps://companyName.my.workfront.com/group/575b000800467a6f66e747932c807464/members
の場合、グループ ID は575b000800467a6f66e747932c807464
です。-
setCatObjCode
= フォームを作成するオブジェクトタイプのオブジェクトコードです。 次のオプションからコードを入力します。CMPY
(会社)TASK
(タスク)PROJ
(プロジェクト)PORT
(ポートフォリオ)PRGM
(プログラム)USER
(ユーザー)DOCU
(ドキュメント)OPTASK
(イシュー)EXPNS
(費用)ITRN
(イテレーション)BILL
(請求記録)GROUP
(グループ)
NOTE
複数オブジェクトのフォームの場合は、UI でフォームを作成する際に最初に選択するオブジェクトを入力します。例えば、Workfront インターフェイスで「タスク」を選択してから「イシュー」、「ポートフォリオ」などを選択し、そのフォームをプロジェクトでは使用しない場合は、setCatObjCode
にTASK
を設定します。 -
setName
は、Workfront インターフェイスに表示するカスタムフォームの名前です。
-
スプレッドシートを.xls または.xlsx ファイルとしてコンピューターに保存します。Excel スプレッドシートが入力され、Workfront に読み込む準備が整います。
Excel スプレッドシートを Workfront にアップロード
前の項で説明した手順を実行した後、次の手順に従って、新しいフィールドおよびフォームを Workfront にアップロードします。
-
Adobe Workfront の右上隅にある メインメニュー アイコン
-
システム/データの読み込み(キックスタート) をクリックします。
-
「Kick-Start スプレッドシートでデータをアップロードする」セクションで、「ファイルを選択」をクリックします。
-
作成した Excel スプレッドシートをコンピューターで参照し、見つかったら選択します。 Workfrontがファイルを認識すると、「アップロード」ボタンが青に変わります。
-
「アップロード」をクリックします。
-
インポートが成功したことを示す通知が表示されます。インポートする情報の量によっては、この手順に数秒から 1 分かかる場合があります。
新しいカスタムフィールドとフォームが Workfront システムに追加されます。これらは、設定のカスタムフォームエリアにあります。
NOTE
新しいフォームとインポートしたフィールドは、まだ接続されていません。フォームのインポートに、カスタムフィールドは含まれません。カスタムフィールドは、新しいカスタムフォームまたは別の既存のカスタムフォームに手動で追加する必要があります。カスタムフォームにフィールドを追加する方法について詳しくは、「 カスタムフォームの作成」を参照してください。
-
(条件付き)インポートが成功しなかった場合は、問題を示すエラーメッセージが表示されます。問題が発生したフィールド、シートおよび行番号を特定し、Excel ファイルの情報を修正してから、もう一度ファイルを読み込んでみてください。
-
(条件付き)問題の内容によっては、エラーメッセージに記載されているように、一部の情報が既に読み込まれている場合があります。シートを再度読み込むには、まず次のいずれかを行う必要があります。
- Workfront から正常に読み込まれた情報をカスタムフォームエリアから削除し、エラーメッセージに示されている修正を行います。
- 既に読み込まれているフィールドやフォームについては、フィールドやフォームが既にシステムに存在することを示し、修正を行います。
フィールドやカスタムフォームが既に Workfront に存在することを示すには、キックスタート読み込みシートで、フォーム(CTGY
)またはフィールド(PARAM
)に関する情報を含んだシートのinNew
フィールドがFALSE
としてマークされていることを確認します。