カスタムフォームの作成

• プロジェクト
• タスク
• イシュー/リクエスト
• ポートフォリオ
• ドキュメント
• プログラム
• 費用
• ユーザー
• 会社
• イテレーション
• 請求記録
• グループ
• チーム

Workflow Ultimate パッケージを使用している場合は、次のオブジェクトのカスタムフォームを作成することもできます。

• 担当業務
• レートカード
• 割り当て

• 1 行テキスト
• 段落
• リッチテキスト
• 説明テキスト

（必須）カスタムフィールドの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

• 1 行テキスト
• 段落
• リッチテキスト

（必須）この名前は、システムによるフィールドの識別方法です。 初めてウィジェットを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、それに一致します。 「ラベル」フィールドと「API名」フィールドは同期されません。 これにより、システムで表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションが提供されます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

• 1 行テキスト
• 段落
• リッチテキスト
• 説明テキスト

• 1 行テキスト
• 段落
• リッチテキスト

カスタムフィールドに取り込むデータのタイプを選択します。

メモ：

• フォームを保存した後は、このフィールドを編集できません。 数学計算でフィールドを使用する場合は、必ず「数値」または「通貨」フォーマットを選択してください。
• 数値または通貨を選択すると、0 から始まる数値が自動的に切り捨てられます。
• 数値フィールドの文字数制限は 16 です。 テキストフィールドを使用して数値を入力し、制限を回避することもできます。

• 1 行テキスト
• 段落

ユーザーがこのカスタムフィールドを表示または編集する前に必要な財務権限タイプを選択します。 通貨形式を選択する必要があります。

• 権限は必要ありません：すべてのユーザーがこのフィールドを表示できます

• General: ユーザーには、General Financeを編集または表示するための権限が必要です

• 請求： ユーザーには、請求レートを編集または表示するための権限が必要です

• コスト： ユーザーには、コスト率を編集または表示するための権限が必要です

詳しくは、 カスタムフィールド内の財務データへのアクセスを制限を参照してください。

• 1 行テキスト
• 段落

• 1 行テキスト
• 段落

• 説明テキスト

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

• 1 行テキスト
• 段落
• リッチテキスト
• 説明テキスト

• 1 行テキスト
• 段落
• リッチテキスト

（必須）カスタムフィールドの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

（必須）この名前は、システムによるフィールドの識別方法です。 初めてウィジェットを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、それに一致します。 「ラベル」フィールドと「API名」フィールドは同期されません。 これにより、システムで表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションが提供されます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

カスタムフィールドに関する追加情報を入力します。 ユーザーがカスタムフォームに入力する際に、疑問符アイコンの上にポインタを合わせると、ここに入力した情報を含むツールチップが表示されます。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

カスタムフィールドに取り込むデータのタイプを選択します。

メモ：

• フォームを保存した後は、このフィールドを編集できません。 数学計算でフィールドを使用する場合は、必ず「数値」または「通貨」フォーマットを選択してください。
• 数値または通貨を選択すると、0 から始まる数値が自動的に切り捨てられます。
• 数値フィールドの文字数制限は 16 です。 テキストフィールドを使用して数値を入力し、制限を回避することもできます。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

ユーザーがこのカスタムフィールドを表示または編集する前に必要な財務権限タイプを選択します。 通貨形式を選択する必要があります。

• 権限は必要ありません：すべてのユーザーがこのフィールドを表示できます

• General: ユーザーには、General Financeを編集または表示するための権限が必要です

• 請求： ユーザーには、請求レートを編集または表示するための権限が必要です

• コスト： ユーザーには、コスト率を編集または表示するための権限が必要です

詳しくは、 カスタムフィールド内の財務データへのアクセスを制限を参照してください。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

次のいずれかのオプションを選択します。

• 値を表示：それぞれの選択値をフィールドに表示します。 それぞれの選択のラベルは、デフォルトで表示されます。
• A～Z で順に選択肢を並べ替える：フィールドに追加した選択肢をアルファベット順に並べ替えます。

ユーザーに追加するそれぞれの選択肢に対して、「歯車」アイコン をクリックし、以下のオプションのいずれかを選択します。

• デフォルトで選択：フィールドでデフォルトの選択肢を選択します。

• 選択肢を非表示：フィールドで選択肢を非表示にします。 非表示された選択肢は、レポート内で引き続きアクセスできます。

• 選択肢を削除：フィールドから選択肢を削除します。

  警告：この選択肢を使用する現在のオブジェクトがある場合は、フィールドから削除しないでください。 削除すると、履歴データが失われる可能性があります。 その代わりに、非表示にするオプションを選択します。これにより、ユーザーは今後このオプションを選択できなくなります。

メモ：選択できる選択肢の数に制限はありません。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

• ラジオボタン
• チェックボックスグループ
• 単一選択ドロップダウン
• 複数選択ドロップダウン

（必須）ウィジェットの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）この名前は、システムによるフィールドの識別方法です。 初めてウィジェットを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、それに一致します。 「ラベル」フィールドと「API名」フィールドは同期されません。 これにより、システムで表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションが提供されます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

（必須）カスタムフィールドの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）この名前は、システムによるフィールドの識別方法です。 初めてフィールドを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、一致します。 ただし、「ラベル」フィールドと「API名」フィールドは同期されません。これにより、システムに表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションを使用できます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

カスタムフィールドに取り込むデータのタイプを選択します。

メモ：

• フォームの保存後にフォーマットタイプを変更できますが、制限が 1 つあり、オブジェクト上の既存の値はすべて新しいタイプに変換できる必要があります。 （例えば、書式タイプがテキストで、オブジェクトが「abc」という値を格納している場合、フィールドを変換できず、システムが「abc」を数値/通貨に変換できないというエラーが表示されます）。 数学計算でフィールドを使用する場合は、必ず「数値」または「通貨」フォーマットを選択してください。
• 数値または通貨を選択すると、0 から始まる数値が自動的に切り捨てられます。
• 数値フィールドの文字数制限は 16 です。 テキストフィールドを使用して数値を入力し、制限を回避することもできます。

ユーザーがこのカスタムフィールドを表示または編集する前に必要な財務権限タイプを選択します。 通貨形式を選択する必要があります。

• 権限は必要ありません：すべてのユーザーがこのフィールドを表示できます

• General: ユーザーには、General Financeを編集または表示するための権限が必要です

• 請求： ユーザーには、請求レートを編集または表示するための権限が必要です

• コスト： ユーザーには、コスト率を編集または表示するための権限が必要です

詳しくは、 カスタムフィールド内の財務データへのアクセスを制限を参照してください。

API の URL を入力するか貼り付けます。

API URL は、ドロップダウンに表示するオプションの JSON コンテンツを返す必要があります。 JSON パスフィールドを使用することで、返された JSON からドロップダウンオプションとして特定の値を選択できます。

API URL を入力する際に、オプションで URL に次の値を渡すことができます。

• $$HOST - これは現在の Workfront ホストを表し、Workfront API に対する API 呼び出しの作成／検索に使用できます。 このワイルドカードを使用すると、認証が処理され、ユーザーは認証ヘッダーを送信する必要がありません。 （例えば、ユーザーはベース URL $$HOST/attask/api/task/search を使用してタスクを検索できるので、タスクの検索および返されたタスクのリストからの値の選択ができるようになります）。

• $$QUERY - これはエンドユーザーがフィールドに入力する検索テキストを表し、エンドユーザーに対するクエリフィルタリングを実装できます。 （ユーザーはドロップダウン内で値を検索します。）

  参照している API で許可されている場合は、検索クエリに修飾子を入れて、検索の動作方法を識別することもできます。 例えば、次のようにベース API の URL として使用すると、特定のテキストを含む任意の Workfront プロジェクトをユーザーが検索できるようになります。$$HOST/attask/api/v15.0/proj/search?name=$$QUERY&name_Mod=contains

  Workfront の検索修飾子について詳しくは、API の基本を参照してください。

  メモ：$$QUERY を使用せず、ユーザーが検索ボックスにテキストを入力した場合は、既存の選択項目が絞り込まれます。 ただし、$$QUERY を使用し、ユーザーが何かを入力した場合は、API へのネットワーク呼び出しが新たに実行されます。 したがって、API に 2,000 個を超える値があり、API がクエリをサポートしている場合、$$QUERY を活用して、既存の 2,000 個の値から検索するだけでなく、絞り込まれたオプションを持つ元の API からも検索できます。

• {fieldName} - fieldName が Workfront の任意のカスタムフィールドまたはネイティブフィールドである場所。 こうして、既に選択されているフィールドの値を外部ルックアップフィールドに渡してオプションをフィルターダウンする際に、カスケードドロップダウンオプションフィルターを実装できます。 （例えば、地域フィールドが既にフォーム上に存在し、API から国のリストを特定の地域に属する国に絞り込みます）。

  他のフィールド（{fieldName} 構文を使用）に依存関係を持つ外部ルックアップフィールドの場合、API から返されるオプションは、他のフィールドに入力された文字列や値と一致するものに制限されます。 （この機能は、リストとレポートではサポートされていません）。

• {referenceObject}.{fieldName} - フィールドがオブジェクトの一部である場所。 この構文はカスタム式に似ています。 （例：portfolioID={project}.{portfolioID}）

メモ：定義できる特定のクエリについて詳しくは、使用している API のドキュメントを確認してください。

API の JSON パスを入力するか貼り付けます。

このオプションを使用すると、API URL から返された JSON からデータを抽出できます。 これは、JSON 内のどの値がドロップダウンオプションに表示されるかを選択する手段の役割を果たします。

例えば、API URLが次の形式でJSONを返す場合、「$.data[*].name」を使用してドロップダウンオプションとして米国とカナダを選択できます。

   {
    データ：{
      { name: "USA"},
      { name: "Canada"}
    }
   }

JSON パスと、正しい JSON パスを記述する方法について詳しくは、https://jsonpath.com/ を参照してください。

「ヘッダーを追加」をクリックし、API での認証に必要なキーと値のペアを入力するか、ペーストします。

メモ：ヘッダーフィールドは、資格情報を格納するには安全な場所ではありません。入力して保存する内容に注意する必要があります。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

（必須）カスタムフィールドの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）この名前は、システムによるフィールドの識別方法です。 初めてフィールドを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、一致します。 ただし、「ラベル」フィールドと「API名」フィールドは同期されません。これにより、システムに表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションを使用できます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

フィールドに関連付けるオブジェクトタイプを選択します。

「適用」または「保存して閉じる」をクリックした後は、フィールドのオブジェクトタイプを変更できません。

メモ：

• Workfront 管理者が Workfront ユーザーインターフェイスでポートフォリオ、プログラム、またはプロジェクトの名前をカスタマイズした場合、このドロップダウンリストには、カスタマイズされた名前ではなく、オブジェクトのデフォルトの Workfront 名が表示されます。 これについてサポートが必要な場合は、Workfront 管理者にお問い合わせください。
• iOS および Android Workfront Mobile アプリでは、ユーザー、会社、グループ、担当業務、ポートフォリオ、プログラム、プロジェクト、テンプレートの各オブジェクトタイプがサポートされています。

オブジェクトタイプにフィルターを追加して、ユーザーがフィールドを使用する際に選択できるオブジェクトを制限します。

例えば、以下の条件を満たすユーザー名のみを選択できるようにフィールドを制限できます。

• 自分が指定した 1 つ以上のグループに属している
• 自分が指定した役割または役職に関連付けられている
• フィールドを使用するユーザーと同じグループに属している

テキストモードの構文を使用して、選択したオブジェクトタイプのフィルターを定義する必要があります。 テキストモードを使用したフィルターの作成について詳しくは、テキストモードを使用したフィルターの編集を参照してください。

ヒント： フィルターを内部検索フィールドに直接追加する前に、フィルターをテストするレポートを作成できます。 これにより、フィルターが正しいオブジェクトを返すことを確認できます。 次に、レポートでテキストモードに切り替え、テキストモードステートメントをコピーして、内部参照フィルターに追加できます。

メモ：

• 既存のカスタムフォームを編集する場合、内部検索フィールドにフィルターを追加しても、ユーザーがフィールドを使用して既に追加したオブジェクト（フィルターの範囲外）は削除されません。
• このフィルターは、モバイルデバイスでは使用できません。 内部検索フィールドにフィルターを使用すると、そのフィールドは、フィルターの影響を受けないユーザーのモバイルデバイスに表示されます。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

（必須）ウィジェットの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）この名前は、システムによるウィジェットの識別方法です。 初めてウィジェットを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、それに一致します。 「ラベル」フィールドと「API名」フィールドは同期されません。 これにより、システムで表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションが提供されます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）インターネット上に保存されているウィジェットの URL を入力するか貼り付けます。

ビデオウィジェットを追加する場合は、現在、URL ボックスに次の内容を追加して実行できます。

• YouTube または Vimeo リンク

• Google Drive ビデオリンク

• MP4 および MOV 拡張子を持つビデオへのリンク

• Workfront インスタンスのドキュメントエリアに既にアップロードされているビデオへのリンク。 手順については、ドキュメントエリアからカスタムフォームにビデオウィジェットを追加を参照してください。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

（必須）カスタムフィールドの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）この名前は、システムによるフィールドの識別方法です。 初めてフィールドを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、一致します。 「ラベル」フィールドと「API名」フィールドは同期されません。 これにより、システムで表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションが提供されます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）Workfront ネイティブフィールドを選択します。

使用できるのは、フォームのオブジェクト用のネイティブフィールドのみです。 例えば、フォーム designer の上部にある「オブジェクトタイプ」リストに「プロジェクト」と表示されている場合は、プロジェクトのネイティブフィールドを選択できますが、タスクに固有のフィールドは選択できません。

参照フィールドにフィルターを追加して、ユーザーがフィールドを使用する際に選択できるアイテムのリストを制限します。

例えば、以下の条件を満たすユーザー名のみを選択できるようにフィールドを制限できます。

• 自分が指定した 1 つ以上のグループに属している
• 自分が指定した役割または役職に関連付けられている
• フィールドを使用するユーザーと同じグループに属している

フィールドにシステムフィルターが存在する場合、カスタムフィルターを追加しない場合は、デフォルトで適用されます。 カスタムフィルターは、システムフィルターを上書きします。

テキストモードの構文を使用して、選択した参照フィールドのフィルターを定義する必要があります。 詳しくは、テキストモードを使用したフィルターの編集を参照してください。

ダイナミックフィルター構文を使用して、別のフィールドの値に基づいて、このフィールドの項目のリストを絞り込みます。 例えば、「プロジェクト」フィールドフィルターで?portfolioID={portfolio}.{ID}を使用し、Portfolio ネイティブフィールドがカスタムフォーム上にある場合、「プロジェクト」フィールドには、選択したポートフォリオ内のプロジェクトのみが表示されます。 「Portfolio」フィールドが空白のままになっている場合は、「プロジェクト」フィールドにすべてのプロジェクトが表示されます。

メモ：

• フィルターオプションは、ネイティブの先行入力またはPortfolio、会社、オーナーなどの内部検索フィールドを参照する場合にのみ使用できます。
• 既存のカスタムフォームを編集している場合、ネイティブフィールドにフィルターを追加しても、ユーザーがフィールドを使用して既に追加した（フィルターの範囲外の）オブジェクトは削除されません。
• このフィルターは、モバイルデバイスでは使用できません。 ネイティブフィールドにフィルターを使用すると、このフィールドは、フィルターの影響を受けずに、ユーザーのモバイルデバイスに表示されます。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

（必須）ウィジェットの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルでは特殊文字がレポートに正しく表示されないので、特殊文字を使用しないでください。 詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）この名前は、システムによるウィジェットの識別方法です。 初めてウィジェットを設定し、ラベルを入力すると、API名フィールドが自動的に入力され、それに一致します。 「ラベル」フィールドと「API名」フィールドは同期されません。 これにより、システムで表示される名前を変更することなく、ユーザーに表示されるラベルを変更するオプションが提供されます。

詳しくは、フィールド名とラベルに関するメモを参照してください。

（必須）有効な XD プロトタイプリンクを入力するかペーストします。

メモ：Adobe XD の「共有」タブのリンクアクセスの設定は、リンクを知っているすべてのユーザーに設定する必要があります。 そうしないと、ユーザーはプロトタイプを表示できなくなります。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。

（必須）カスタムフィールドの上に表示する説明ラベルを入力します。 ラベルはいつでも変更できます。

重要：このラベルで特殊文字を使用しないでください。

Planning レコードの取得元を簡単に識別できるラベルを選択することをお勧めします。 ワークスペースの名前やレコードタイプの名前などの情報を追加します。

（推奨）フィールドに関する追加情報を入力します。 ユーザーがカスタムフォームに入力する際に、疑問符アイコンの上にポインタを合わせると、ここに入力した情報を含むツールチップが表示されます。

ここでは、接続しているレコードとオブジェクトに関する詳細情報を追加できます。

（必須）Workfront Planning のレコードタイプに接続された Workfront オブジェクトタイプを選択します。

次のオブジェクトタイプから選択できます。

• プロジェクト
• ポートフォリオ
• プログラム
• 会社
• グループ

フォームのオブジェクトタイプ用の Workfront オブジェクトタイプのみを使用できます。

例えば、フォームデザイナーの上部にある「オブジェクトタイプ」リストに「プロジェクト」と表示されている場合は、このフィールドで「プロジェクト」のみを選択できます。ポートフォリオはレコードタイプにも接続できますが、ポートフォリオは選択できません。

（必須）Workfront に表示するレコードの元となる Planning ワークスペースを選択します。

「オブジェクトタイプ」フィールドで選択したオブジェクトタイプに接続されているワークスペースのみが表示されます。

（必須）Workfront オブジェクトタイプと接続されている Workfront Planning レコードタイプを選択します。

「オブジェクトタイプ」フィールドで選択したオブジェクトタイプに接続するレコードタイプのみが表示されます。

（必須）Workfront オブジェクトに表示する選択した Planning レコードタイプと Workfront オブジェクトタイプの間の接続フィールドを選択します。

メモ：同じオブジェクトとレコードタイプ間に複数の接続フィールドを持つことができますが、選択できるフィールドは 1 つだけです。

（オプション）カスタムフォームに表示する、接続されたレコードタイプから最大 7 つのルックアップフィールドを選択します。 プライマリフィールドはデフォルトで選択されており、編集できません。

選択した接続レコードのフィールドは、カスタムフォームのテーブルビューに表示されます。 フォームが Workfront オブジェクトに添付されている場合、テーブルビューは読み取り専用です。

このオプションは、デフォルトでオンになっています。

フィールドを非アクティブに設定すると、そのフィールドはレポート、フィルター、ビューから除外され、カスタムフォームフィールドライブラリでは使用できなくなります。