Figma モジュール

Adobe Workfront Fusion Figma モジュールを使用して、コメント、ファイル、ファイルバージョン、またはプロジェクトの一覧を取得できます。また、コメントを投稿したり、Figma API を呼び出したりすることもできます。

シナリオの作成手順が必要な場合は、🔗 でのシナリオの作成を参照してください。

モジュールについては、モジュール: Adobe Workfront Fusionを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Figma モジュールを使用するには、Figma アカウントが必要です。

Figma API 情報

Figma コネクタでは、以下を使用します。

ベース URL
https://api.figma.com/v1
API バージョン
v1
API タグ
v1.8.25

Figma モジュールとそのフィールド

Figma モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Figma フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

コメント

コメントを削除

このアクションモジュールは、ファイルから 1 つのコメントを削除します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
File ID
コメントを追加もしくは削除するファイルのファイル ID を入力またはマッピングします。
Comment
削除するコメントのテキストを入力します。

コメントを一覧表示

この検索モジュールは、Figma の単一ファイルについたすべてのコメントを一覧表示します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
File ID

コメントを取得するファイルのファイル ID を入力またはマッピングします。

  • ID が不明な場合は、Find Files をクリックし、ファイルが関連付けられているプロジェクトの ID を入力またはマッピングし、ファイルを選択します。

  • プロジェクトの ID が不明な場合は、Find Projects をクリックし、ファイルが関連付けられているプロジェクトを所有するチームの ID を入力またはマッピングして、プロジェクトを選択してから、ファイルを選択します。

Limit
各シナリオの実行サイクル中にモジュールが返すコメントの最大数を入力またはマッピングします。

コメントを投稿

このアクションモジュールは、Figma ファイルにコメントを投稿します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
File ID

コメントを投稿するファイルのファイル ID を入力またはマッピングします。

  • ファイルの ID が不明な場合は、Find Files をクリックし、ファイルが関連付けられているプロジェクトの ID を入力またはマッピングして、ファイルを選択します。

  • ファイルの ID を探していて、プロジェクトの ID が不明な場合は、Find Projects をクリックし、ファイルが関連付けられているプロジェクトを所有するチームの ID を入力またはマッピングします。プロジェクトを選択したあと、ファイルを選択します。

Comment
コメントのテキストを入力します。

プロジェクトとファイル

ファイルまたは画像の取得

このアクションモジュールは、Figma ライブラリから 1 つのファイルまたは画像を取得します

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Object type

取得するオブジェクトのタイプを選択します。

  • File

    このモジュールは、Keyで参照されるドキュメントを JSON オブジェクトとして返します。ファイルキーは、任意の Figma ファイル URL から解析できます。

    フィールドについては、Get a file or image: Fileを参照してください。

  • File nodes

    ID で参照されるノードを JSON オブジェクトとして返します。ノードは、Keyで参照される Figma ファイルから取得されます。

    フィールドについては、Get a file or image: File nodesを参照してください。

  • Image

    このモジュールは、ファイルから画像をレンダリングします。

    フィールドについては、Get a file or image: Imageを参照してください。

  • Image fills

    このモジュールは、ドキュメント内の画像の塗りに存在するすべての画像のダウンロードリンクを返します。画像の塗りは、ユーザーが指定した画像を Figma で表現する方法です。画像を Figma にドラッグすると、その画像を表す単一の塗りを持つ長方形が Figma で作成されます。ユーザーは、その長方形(および塗りのプロパティ)を変形できます。

    フィールドについては、Get a file or image: Image fillsを参照してください。

ファイルまたは画像の取得:ファイル
File key
JSON を返す元となるファイルを選択します。
Version ID
モジュールが返すファイルのバージョンを入力またはマッピングします。現在のモジュールでは、このフィールドを空白のままにします。
Node IDs

ドキュメントのサブセットのみを返すには、モジュールが返すノードを入力します。このモジュールは、リストされたノード、その子、およびルートノードとリストされたノードの間のすべてのノードを返します。

返すノードごとに、「Add」をクリックしてノードのテキストを入力します。

Depth

結果を返すドキュメントツリー内の深さを表す整数を入力またはマッピングします。

例:

  • ページのみを返すには、1 を入力します。

  • ページとトップレベルのオブジェクトを返すには、2 を入力します。

すべてのノードを返す場合は、このフィールドを空白のままにします。

Geometry
ベクトルデータを返すには、paths を入力します。
Plugin data
プラグイン ID や文字列「shared」のコンマ区切りリスト。これらのプラグインによって書き込まれたドキュメント内に存在するすべてのデータは、pluginData プロパティと sharedPluginData プロパティの結果に含まれます。
Branch data
要求されたファイルのブランチメタデータを返すには、このオプションを有効にします。ファイルがブランチの場合、返される応答にメインファイルのキーが含まれます。ファイルにブランチがある場合、そのメタデータが返される応答に含まれます。デフォルト:false
ファイルまたは画像を取得:ファイルノード
File key
JSON を返す元となるファイルを選択します。
Node IDs

モジュールが返し、変換するノードを入力します。

返すノードごとに、「Add」をクリックしてノードのテキストを入力します。

Version ID
モジュールが返すファイルのバージョンを入力またはマッピングします。現在のモジュールでは、このフィールドを空白のままにします。
Depth

結果を返すドキュメントツリー内の深さを表す整数を入力またはマッピングします。

例:

  • ページのみを返すには、1 を入力します。

  • ページとトップレベルのオブジェクトを返すには、2 を入力します。

すべてのノードを返す場合は、このフィールドを空白のままにします。

Geometry
ベクトルデータを返すには、paths を入力します。
Plugin data
プラグイン ID のコンマ区切りリストや文字列「shared」。これらのプラグインによって書き込まれたドキュメント内に存在するすべてのデータは、pluginData プロパティと sharedPluginData プロパティの結果に含まれます。
ファイルまたは画像を取得:画像
File key
JSON を返す元となるファイルを選択します。
Node IDs

モジュールがレンダリングするノードを入力します。

レンダリングするノードごとに、「Add」をクリックしてノードのテキストを入力します。

Scale
画像を拡大・縮小するには、拡大・縮小率を入力またはマッピングします。この数は 0.01~4 の範囲で指定する必要があります。
Format

画像出力の形式を選択します。

  • JPG

  • PNG

  • SVG

  • PDF

SVG - Include ID
すべての SVG 要素の ID 属性を含めるには、このオプションを有効にします。デフォルト:false。
SVG - Simplify Stroke
内部や外部のストロークを簡略化し、可能な場合に <mask> の代わりにストローク属性を使用するには、このオプションを有効にします。デフォルト:true。
Use absolute bounds
ノードがトリミングされているか、ノードの周囲のスペースが空であるかに関係なく、ノードの全寸法を使用するには、このオプションを有効にします。トリミングせずにテキストノードを書き出すには、このオプションを使用します。デフォルト:false。
Version ID
モジュールが返すファイルのバージョンを入力またはマッピングします。現在のモジュールでは、このフィールドを空白のままにします。
ファイルまたは画像の取得:画像の塗り
File key
JSON を返す元となるファイルを選択します。

ファイルのバージョン履歴のリスト

この検索モジュールは、Figma 内の単一ファイルのバージョン履歴を返します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
File ID

バージョン履歴を取得するファイルのファイル ID を入力またはマッピングします。

  • ファイルの ID が不明な場合は、「Find Files」をクリックして、ファイルが関連付けられているプロジェクトの ID を入力またはマッピングしたあと、ファイルを選択します。

  • ファイルの ID を探していて、プロジェクトの ID が不明な場合は、Find Projects をクリックし、ファイルが関連付けられているプロジェクトを所有するチームの ID を入力またはマッピングします。プロジェクトを選択したあと、ファイルを選択します。

Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

プロジェクトファイルのリスト

この検索モジュールは、指定されたプロジェクト内のすべてのファイルのリストを返します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
File ID

ファイルを取得するプロジェクトのプロジェクト ID を入力またはマッピングします。

  • プロジェクトの ID が不明な場合は、「Find Projects」をクリックして、プロジェクトが関連付けられているチームの ID を入力またはマッピングしたあと、プロジェクトを選択します。
Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

プロジェクトのリスト

この検索モジュールは、指定したチーム内のすべてのプロジェクトのリストを返します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Team ID
ファイルを取得するプロジェクトのプロジェクト ID を入力またはマッピングします。チーム ID は、Figma のチームのページの URL で確認できます。
Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

コンポーネントとスタイル

スタイルまたはコンポーネントを取得

このアクションモジュールは、1 つのスタイルまたはコンポーネント、またはスタイルまたはコンポーネントのセットを取得します。

Connection
Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
<Object> key
取得するオブジェクトのキー(一意の ID)を入力します。
Team ID
レコードが関連付けられているチームの ID を入力またはマッピングします。
Page Size
ページごとに返す数値または結果を入力またはマッピングします。デフォルト:30。
After

結果の取得を開始する結果の番号を入力またはマッピングします。これを Page Size フィールドと組み合わせて、結果をページ分割することができます。

この値はオブジェクト ID に対応していません。

このフィールドは、Before フィールドと組み合わせて使用することはできません。

Before

結果の取得を開始する前に結果の番号を入力またはマッピングします。これを Page Size フィールドと組み合わせて、結果をページ分割することができます。

この値はオブジェクト ID に対応していません。

このフィールドは、After フィールドと組み合わせて使用できません。

その他

API 呼び出しを実行

このアクションモジュールは、認証について考えることなく、Figma API に対して認証済みのカスタム呼び出しを実行できます。これにより、他のモジュールでは不可能なデータフローオートメーションを作成できます。

Connection
Figma アカウント Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
URL

https://api.figma.com/v1/ への相対パスを入力します。

例: files/7179110/comments

Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion によって、認証ヘッダーが追加されます。

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例: {"name":"something-urgent"}

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

イベントを見る

このトリガーモジュールは、Figma チームスペース内の特定のチームに対して次のイベントのいずれかが発生したときにシナリオを開始します。

  • ファイルの更新

  • ファイルのバージョン更新

  • ファイルの削除

  • ライブラリの公開

  • ファイルのコメント

Webhook

モジュールが監視する web フックを選択します。

新規の web フックを追加するには、次の手順に従います。

  1. Webhook フィールドの横にある「Add」をクリックします。

  2. この web フックに使用する接続を選択します。Figma アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。

  3. モジュールで監視するイベントタイプを選択します。

  4. Web フックでイベントを監視するチームの ID を入力します。

  5. Web フックで監視するイベントの Status または Description を入力します。

  6. Save」をクリックして web フックを保存し、モジュールに戻ります。

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