Figma モジュール

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

シナリオの作成手順については、 シナリオを作成:記事インデックスの記事を参照してください。

モジュールについて詳しくは、「 モジュール:記事インデックス」の記事を参照してください。

アクセス要件

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ 任意
Adobe Workfront プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンスは必要ありません。

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

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

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 モジュールの接続を作成するには:

  1. 任意の Figma モジュールで、「接続」ボックスの横にある「Add」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection type

    新しい接続の場合は、従来のタグを付けずに Figma を選択します。

    Figma は、2025 年 1 月に認証要件を変更しました。 この Figma 接続タイプは新しい要件を満たしています。 Figma (Legacy) 接続タイプは今後削除されます。

    Connection name この接続の名前を入力します。
    Client ID Figme Client ID を入力します。
    Client Secret Figma Client Secret を入力します。
    カスタム スコープ この接続に必要なカスタム スコープを入力します。
    カスタム接続確認 URL 接続が正常に作成されたことを検証するデフォルトのエンドポイントは次のとおりです。https://api.figma.com/v1/me この URL がカスタム範囲でサポートされていない場合は、カスタム検証 URL を指定します。
  3. Continue」をクリックして接続を保存し、モジュールに戻ります。

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

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

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

マップ切り替え

コメント

Delete a comment

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

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

List comments

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

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

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

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

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

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

Post a comment

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

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

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

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

  • ファイルの ID を見つけようとして、プロジェクトの ID が分からない場合は、「Find Projects」をクリックし、ファイルが関連付けられているプロジェクトを所有するチームの ID を入力またはマップします。 プロジェクトを選択したあと、ファイルを選択します。

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

プロジェクトとファイル

Get a file or image

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

Connection
Figma アカウントを Workfront Fusion に接続する手順については、この記事の Figma への接続の作成を参照してください。
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
モジュールが返すファイルのバージョンを入力またはマッピングします。現在のモジュールでは、このフィールドを空白のままにします。
ファイルまたは画像の取得:画像の塗り
File key
JSON を返す元となるファイルを選択します。

List file version history

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

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

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

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

  • ファイルの ID を見つけようとして、プロジェクトの ID が分からない場合は、「Find Projects」をクリックし、ファイルが関連付けられているプロジェクトを所有するチームの ID を入力またはマップします。 プロジェクトを選択したあと、ファイルを選択します。

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

List project files

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

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

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

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

List projects

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

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

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

Get a style or component

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

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

チームコンポーネントまたはチームコンポーネントセットを取得する場合は、結果の数を入力するかマッピングして、その数を超えると結果の取得が開始されるようにします。 これを Page Size フィールドと組み合わせると、結果にページ番号を付けることができます。

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

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

Before

チームコンポーネントまたはチームコンポーネントセットを取得する場合は、結果の数を入力するかマッピングしてから、結果の取得を開始します。 これを Page Size フィールドと組み合わせると、結果にページ番号を付けることができます。

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

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

その他

Make an API call

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

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

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

例: files/7179110/comments

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

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

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

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

Query String

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

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

Body

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

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

Watch events

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

  • ファイルの更新

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

  • ファイルの削除

  • ライブラリの公開

  • ファイルのコメント

Webhook

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

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

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

  2. Web フックの名前を入力します。

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

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

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

  6. Webhook をアクティブにするか一時停止するかを選択します。

  7. Webhook の説明を入力します。

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3