キックスタートテンプレートを使用したWorkfrontへのデータの読み込み

キックスタートは、Workfront に読み込むデータを入力できる特別な形式の Excel ワークブックです。キックスタートデータインポーターで説明されているように、Adobe Workfront には、そのためのキックスタートテンプレートが用意されています。

このプロセスは、3 つの主なタスクに分かれています。

  • まず、キックスタートテンプレートをスプレッドシートファイルとして書き出します。
  • 次に、スプレッドシートにデータを入力します
  • 最後に、入力済みのスプレッドシートを Workfront に読み込みます

この記事では、これらの手順について、適切な順序で説明します。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事の手順を実行するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront プラン 任意
Adobe Workfront プラン

新規:標準

または

現在:プラン

アクセスレベル設定 System Administrator

この表の情報について詳しくは、Workfront ドキュメントのアクセス要件を参照してください。

制限事項

キックスタートテンプレートを使用して、Workfront に多数のオブジェクトを読み込むことができます。ただし、次の制限事項に注意してください。

  • この方法でデータを読み込んでも、Workfront に既に存在するレコードの情報は更新されません。
  • 読み込めるのは、新しいレコードとその情報のみです。
  • 読み込みがタイムアウトしないように、一度に読み込むレコードを 2,000 件以下にします

キックスタートテンプレートをスプレッドシートファイルとして書き出す

キックスタートテンプレートを書き出すと、空の Excel スプレッドシートワークブックが表示されます。スプレッドシートがコンピューターにダウンロードされたら、それを使用して情報を入力し、再び Workfront に読み込むことができます。

キックスタートテンプレートを書き出すには、次の手順に従います。

  1. Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、または(使用可能な場合)左上隅にある​ メインメニュー ​アイコン メインメニュー 、「設定 設定アイコン の順にクリックします。

  2. システムデータを読み込み(キックスタート) ​をクリックします。

  3. 含める情報のタイプを選択します。

    選択した各オプションは、書き出されたスプレッドシート内の複数のタブのコレクションを表します。たとえば、「レポート」オプションを選択した場合は、レポートの作成に必要なすべてのオブジェクト(ビュー、フィルター、グループ化、レポート)がスプレッドシートに含まれます。

    下記のすべてのオブジェクトタイプを使用して、データを Workfront に読み込むことができます。(唯一の例外は、「アクセスレベル」オプションです。書き出されたアクセスレベルデータシートは、参照用に提供されています。ID に基づいて、新しいユーザーアカウントにアクセスレベルを割り当てることができます)。

    各オブジェクトタイプのテンプレートは、次のファイル形式で書き出すことができ、次のシートを含んでいます。

    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
    オブジェクト 書き出し形式 書き出されたスプレッドシート内のシート

    ダッシュボード

    システム内のすべてのダッシュボードを書き出すことができます。1 回の書き出しで最大 100 個の特定のダッシュボードを選択できます。

    ZIP ファイルとして書き出し

    パラメーター

    説明テキスト

    パラメーターオプション

    パラメーターグループ

    カテゴリパラメーター

    カテゴリ

    レポート

    ポータルのタブセクション

    ダッシュボード

    環境設定

    レポート

    システム内のすべてのレポートを書き出すことができます。1 回の書き出しで、最大 100 個の特定のレポートを選択できます。

    キックスタートは、テキストモードのフィルターやグループ化をサポートしていません。 正常に書き出すには、レポートフィルターとグループ化を標準モードに切り替える必要があります。

    ZIP ファイルとして書き出し

    パラメーター

    説明テキスト

    パラメーターオプション

    パラメーターグループ

    カテゴリパラメーター

    カテゴリ

    レポート

    環境設定

    承認 Excel ファイルとして書き出し

    ステージ承認者

    承認ステージ

    承認

    承認プロセス

    環境設定

    カスタムデータ Excel ファイルとして書き出し

    パラメーター

    説明テキスト

    パラメーターオプション

    パラメーターグループ

    カテゴリパラメーター

    カテゴリ

    環境設定

    費用タイプ Excel ファイルとして書き出し

    費用タイプ

    環境設定

    時間タイプ Excel ファイルとして書き出し

    時間タイプ

    環境設定

    チーム Excel ファイルとして書き出し

    チームメンバー

    チーム

    環境設定

    ユーザー Excel ファイルとして書き出します。オプションの完全なリストを表示するには、「その他のオプション」をクリックします。

    ユーザー

    環境設定

    アクセスレベル Excel ファイルとして書き出し

    アクセスレベル

    環境設定

    割り当て Excel ファイルとして書き出し

    割り当て

    環境設定

    会社 Excel ファイルとして書き出し

    会社

    環境設定

    メールテンプレート Excel ファイルとして書き出し

    メールテンプレート

    環境設定

    費用 Excel ファイルとして書き出し

    費用'

    環境設定

    外部ページ Excel ファイルとして書き出し

    外部ページ

    環境設定

    フィルター ZIP ファイルとして書き出し

    フィルター

    環境設定

    グループ Excel ファイルとして書き出し

    グループ

    環境設定

    グループ化 ZIP ファイルとして書き出し

    グループ化

    環境設定

    時間 Excel ファイルとして書き出し

    時間

    環境設定

    イシュー Excel ファイルとして書き出し

    イシュー

    環境設定

    担当業務 Excel ファイルとして書き出し

    担当業務

    環境設定

    マイルストーンパス Excel ファイルとして書き出し

    マイルストーン

    マイルストーンパス

    環境設定

    メモ Excel ファイルとして書き出し

    メモ

    環境設定

    ポートフォリオ Excel ファイルとして書き出し

    ポートフォリオ

    環境設定

    プロジェクト Excel ファイルとして書き出し

    キュー

    プロジェクト

    ルーティングルール

    キューのトピック

    環境設定

    リソース見積り Excel ファイルとして書き出し

    リソース見積り

    環境設定

    リスク Excel ファイルとして書き出し

    リスク

    環境設定

    リスクタイプ Excel ファイルとして書き出し

    リスクタイプ

    環境設定

    スコアカード Excel ファイルとして書き出し

    スコアカードの質問

    スコアカード オプション

    スコアカード

    環境設定

    タスク Excel ファイルとして書き出し

    タスク

    環境設定

    テンプレート Excel ファイルとして書き出し

    キュー

    テンプレート

    ルーティングルール

    キューのトピック

    環境設定

    テンプレートの割り当て Excel ファイルとして書き出し

    テンプレートの割り当て

    環境設定

    テンプレートタスク Excel ファイルとして書き出し

    テンプレート タスク

    環境設定

    タイムシート Excel ファイルとして書き出し

    定期タイムシート

    タイムシート

    環境設定

    表示 ZIP ファイルとして書き出し

    表示

    環境設定

  4. ダウンロード」をクリックします。

  5. スプレッドシートテンプレートにデータを入力する」に進み、空のテンプレートのスプレッドシートに情報を入力します。

スプレッドシートテンプレートにデータを入力する populate-the-spreadsheet-template-with-your-data

スプレッドシートに含まれるタブ(データシート)の概要

TIP
キックスタートテンプレートにデータを入力するときに、各列の情報をどのようにフォーマットする必要があるかをより深く理解するには、読み込もうとしているオブジェクトの既存の Workfront データを含むキックスタートを書き出して、練習を実行することを検討してください。手順については、キックスタートを介して Adobe Workfront からデータを書き出すを参照してください。

空のキックスタートテンプレートを開くと、多数のタブ(データシート)を使用できます。これらは、ダウンロード対象として選択したオブジェクトによって異なります。各オブジェクトは、プロジェクト、タスク、時間、ダッシュボード、ユーザーなど、アプリケーション内の 1 つのオブジェクトを表します。

これらのタブの 1 つを開くと、行 2 には読み込み時に設定できる各オブジェクトのフィールドが表示されます。列ヘッダーでは、「設定」という単語の後に、データベース内での表示に従ってフィールドの名前が表示されます。これらのフィールドは、列ヘッダーとして機能します。

IMPORTANT
エラーを回避するには、次の点を確認します。
  • キックスタートスプレッドシートの最初の空行を削除しないでください。
  • これらのフィールド(列のヘッダー)は削除、変更、入れ替えを行わないでください。例えば、順序や名前は変更しないでください。
  • 列ヘッダーに太字で表示されるすべてのフィールドに値を追加します。これらは必須フィールドを表します。
ただし、必須フィールドにシステム環境設定で設定されたデフォルト値が含まれている場合は、入力する必要はありません。
例えば、「PROJ プロジェクト」タブ、「setCondition」および「setConditionType」フィールドを空のままにすることはできますが、「setGroupID」および「setName」列ではできません。
  • setResourceRevenuesetEnteredByID などの特定のフィールドは、システムによって自動的に生成されます。スプレッドシートのこれらのフィールドにデータを入力しても、スプレッドシートをアップロードする際にキックスタートプロセスによって上書きされます。

レコードを読み込む import-a-record

シートの各行は、一意のオブジェクトに対応します。

  1. isNew 列に情報を追加します。

    • 読み込むオブジェクトが新規の場合は、TRUE と入力して行にデータを読み込みます。この値は大文字と小文字が区別され、常に大文字の英字である必要があります

    • Workfront に既にオブジェクトがある場合は、isNew 列に FALSE と入力して行を無視します。この値は大文字と小文字が区別され、常に大文字の英字である必要があります

      • Workfront に既に存在するレコードは更新されません。
      • Workfront からデータを含むテンプレートをダウンロードした場合、既存のオブジェクトにはあらかじめ FALSE が付けられます。
      • 空のテンプレートをダウンロードした場合は、既存のオブジェクトに新しい行を追加する必要はありません。
  2. 次のいずれかの方法で、ID 列に情報を追加します。

    • 読み込むオブジェクトが新規であり、isNew 列に TRUE と入力した場合は、ID に任意の数値を入力します。この数値は、スプレッドシート内で一意である必要があります。例えば、3 つのオブジェクトを読み込む場合、それぞれの ID に 1、2、3 を指定できます。

    • Workfront に既にオブジェクトが存在し、isNew 列に FALSE と入力し、かつ既存のオブジェクトに関する新しい情報を読み込む場合、ID は、Workfront に存在するそのオブジェクトの英数字の GUID である必要があります。

    note tip
    TIP
    Workfront でオブジェクトの一意の GUID を調べるには、そのオブジェクトのレポートを作成してそのレポートに ID 列を追加します。その列の各オブジェクトの値は、オブジェクトの GUID です。
    • Workfront に既に存在するレコードは更新されません。
    • データを含むテンプレートをダウンロードした場合、既存のオブジェクトには GUID が既に ID として含まれています。
    • 既存のオブジェクトに基づいて新しいオブジェクトを読み込むには、isNew 列で FALSETRUE に変更し、ID を変更し、読み込む前に必要なデータの補正を行います。

    グループのサンプル ID

    • プロジェクトを読み込む際には、グループ ID を指定する必要があります。

      • Workfront に既にグループが存在する場合は、プロジェクトの setGroupID フィールドに一意の ID を追加する必要があります。
      • Workfront にグループが存在しない場合は、グループ ​シートを読み込むファイルに追加し、グループシートの isNew フィールドを TRUE に設定し、ID 列で新規グループの数値 ID を指定します。新規プロジェクトの setGroupID フィールドは新規グループの数値 ID と一致する必要があります。

      例: ​プロジェクトの場合、setGroupID 列に表示される値は、次のいずれかに該当する必要があります。

      • Workfront インスタンス内の既存のグループの GUID
      • インポート中に新しいグループを作成する場合は、「GROUP」グループ ​シートの ID 列の値(数値)
  3. 必須フィールドおよび読み込み時に入力するその他のフィールドの値を入力します。

  4. (オプション)カスタムデータを追加するには、次の手順に従います。

    • 読み込み処理に含める各カスタムフィールドに対して新しい列を作成します。

    • 対応するカスタムフィールドの新しい各列に、DE: [Workfront に表示されるカスタムフィールド名] ​のように名前を付けます。例えば、「DE: 部門」というカスタムフィールドを作成できます。

    • setCategoryID 列に、このカスタムフィールドが存在する既存のカスタムフォームの GUID を入力します。このフィールドは、カスタムデータを読み込む際に必須です。

    • カスタムフィールドに複数のデータ値(ラジオボタン、チェックボックス、リストなど)を追加する必要がある場合は、「環境設定」タブに表示される縦棒のカスタムデータ区切り記号「|」を使用して値を区切ります。

      例: DE:Departments 列の下に A|D と入力すると、カスタムフォームに部門 A と部門 D が入力されます。

日付を含める include-dates

Workfront は、ほとんどの日付形式を処理できます。ただし、スプレッドシートの日付列が日付形式であることを確認する必要があります。列の形式が一般、数値、テキストの場合、読み込みは失敗します。

TIP
最も一般的な形式は、MM/DD/YYYY 形式です。
例:07/10/2023

Workfront では、日付の一部として時間値も使用できます。

例:07/10/2022 01:30 または 07/10/2022 1:00 PM

日付の時刻を省略した場合、Workfront は次のいずれかを実行します。

  • 時刻が深夜の午前零時であると仮定します。期待する日付の結果を確認するには、システムのタイムゾーンがお使いのタイムゾーンと一致している必要があります。
  • スケジュールに関連付けられたオブジェクト上にある場合、時間は、スケジュールが許可する最も早い時間に従います。
NOTE
UNIX タイムスタンプを使用する場合、値の末尾に 3 つの追加のゼロを含める必要があります。
例えば、タイムスタンプが 7336899000 の場合は、セルに 7336899000000 と入力します。

ワイルドカードを使用 use-wildcards

キックスタートテンプレートのスプレッドシートに入力する際に、以下のワイルドカードを使用できます。

ワイルドカード
動作
$$TODAY

setDate フィールドに使用する場合、このワイルドカードは、キックスタートを読み込んだ日の午前 0 時に日付を設定します。

ワイルドカードは、フィルターでワイルドカードと共に使用できる標準構文を使用して変更できます。

例: 実際に読み込みを実行する日に関係なく、読み込む週の月曜日にプロジェクトを開始する場合は、$$TODAYbw を使用します。これにより、プロジェクトの予定開始日が日曜日午前 12:00 に設定されます。プロジェクトのスケジュールは、その時点では作業を許可していない可能性があるので、月曜日の朝の 9 時に開始します。

$$NOW

setDate に使用する場合、このワイルドカードは、キックスタートの読み込み時にレコードを作成した時刻に従って日付を設定します。

ワイルドカードは、フィルターでワイルドカードと共に使用できる標準構文を使用して変更できます。

例: プロジェクトを読み込んでから 3 時間後に開始する場合は、$$NOW+3 h を使用します。

$$USER.ID
setAssignedToID または他の userID ベースのフィールドで使用する場合、このワイルドカードは作業を割り当てるか、レコードの読み込みを実行する個人に関連付けます。
$$CUSTOMER

このワイルドカードは、特にキックスタートユーザーの読み込み用に追加されました。Workfront アカウントを作成すると、システム管理者のアクセスレベルを持つユーザーが作成されます。デフォルトの管理者に割り当てられたユーザー名は、アカウントで他のユーザーを作成する際に接頭辞として使用できます。

ユーザー名はすべての顧客で一意である必要があるため、これは、ユーザー名が「jsmith」の可能性がある John Smith など、非常に一般的なユーザー名を持つ複数の個人がいる場合に便利です。ユーザー名割り当ての前にデフォルトの管理者ユーザー名を付けると、各ユーザー名が一意であることが保証されます(例:$$CUSTOMER.jsmith)。

ヒント:ユーザー名がシステム全体で一意であることを保証するより洗練された方法は、「setUsername」フィールドに個人のメールアドレスを入力することです。

ID の属性名の置換 attribute-name-substitution-for-ids

可能な限り ID を使用することがベストプラクティスですが、setAttributeID 値を設定する際に、あるシートから別のシートへ ID を相互参照するのが不便な場合があります。列ヘッダーを変更するだけで、名前で値を参照できます。

例:

  • プロジェクトのインポート

    プロジェクトを読み込む場合は、GROUP Group シートに移動してプロジェクトの setGroupID を設定し、それぞれのグループ ID をメモして PROJ プロジェクト ​シートの正しいセル(setGroupID 列)に貼り付けます。

    これは、少数のグループとプロジェクトで作業する場合に実行できますが、それぞれのグループを複数使用する場合は、実用的ではありません。

    上記の例で属性名の置換を行うには、setGroupID 列ヘッダーを #setGroupID グループ名 ​に変更します。これにより、各プロジェクトのグループを名前で参照できるようになります。

    note note
    NOTE
    属性名の置き換えを使用するオプションは、既存のレコードの参照にのみ制限されます。同じ読み込みで作成するオブジェクトには、名前の置き換えを使用できません。
  • ユーザーの読み込み

    ユーザーを読み込む際に、「ROLE Role」タブの役割のリストから setRoleID を入力します。

    役割 ID の一部は、アカウントに既に存在するレコード用で、その他は読み込み中に作成されます。

    既存の役割に割り当てられた新しいユーザーレコードに対して、名前の置換を使用できます。新しく読み込まれた役割に割り当てられた新しいユーザーレコードに対しては使用できません。

    同じ読み込みファイルで両方のメソッドを使用する方法を次に示します。

    • スプレッドシートの setRoleID 列の左側に列を追加します。

    • 新しい列に #setRoleID ROLE name という名前を付けます。

    • 既存のレコードに役割を割り当てる場合は、#setRoleID ROLE name 列に役割名を入力します。

      新しい役割レコードへの役割割り当ての場合は、ROLE Role シートの setRoleID に割り当てた ID を入力します。

      ユーザーの役割 ID

スプレッドシートデータを Workfront に読み込む

Excel テンプレートにデータを入力した後、そのデータを Workfront にアップロードできます。

キックスタート読み込みでは、次のファイルタイプをサポートしています。

  • Excel(.xls または .xlsx)

  • 圧縮(.zip)ファイル(.xlsx ファイルまたは .xls ファイルのみを含む)

    note note
    NOTE
    次のオブジェクトを参照する Excel スプレッドシートをインポートする場合は、.zip ファイルを使用する必要があります。
    • レポート
    • ドキュメント
    • アバター
    • プロパティファイルの表示、フィルタリング、グループ化
    zip 形式の読み込みファイルを使用する場合、.zip ファイルは .xlsx ファイルや .xls ファイルと同じ名前にする必要があり、すべてのファイルが同じ構造レベル(フォルダーなし)である必要があります。

テンプレートスプレッドシートデータを Workfront に読み込むには、以下の手順を実行します。

  1. Adobe Workfront の右上隅にある​ メインメニュー ​アイコン メインメニュー をクリックするか、または(使用可能な場合)左上隅にある​ メインメニュー ​アイコン メインメニュー 、「設定 設定アイコン の順にクリックします。

  2. システムデータを読み込み(キックスタート) ​の順にクリックします。

  3. キックスタートスプレッドシートを使用してデータをアップロード」セクションで、「ファイルを選択 ​をクリックし、入力されたスプレッドシートを参照して選択します。

  4. アップロード」をクリックします。

    Excel ファイルの Workfront へのアップロードに 5 分以上かかる場合、アプリケーションがタイムアウトし、Workfront はファイルをアップロードできません。

    小さなオブジェクトのバッチでデータを読み込んでみてください。

  5. (条件付き)Workfront Fusion を使用している場合、FLO またはシナリオをオンにできます。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43