---
sourceDocument: Yokohama ビルドのワークフロー
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama ビルドのワークフロー

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# スポークジェネレーターを使用したスポークのビルド

# スポークジェネレーターを使用したスポークのビルド {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年09月02日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

スポークと呼ばれるカスタム統合を開発するための一連の再利用可能なアクションを作成することで、統合タスクを自動化します。

## ストアでアプリを要求する {#spoke-builder__section_tcg_rrx_zxb}

次にアクセスしてください： [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) Web サイトにアクセスして、利用可能なすべてのアプリを表示し、ストアに要求を送信する方法を確認し、 スポークジェネレーター (sn_spoke_builder) をダウンロードしてインストールします。リリースされたすべてのアプリのこれまでのリリースノート情報については、 [ServiceNow Store バージョン履歴リリースノート](https://docs.servicenow.com/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).

## アプリの依存関係 {#spoke-builder__section_ntz_2rx_zxb}

アプリのインストールで問題が発生した場合は、依存プラグイン ServiceNow 統合ハブプロフェッショナルパックインストーラー (com.glide.hub.integrations.professional) がインストールされていることを確認してください。  
注:  
これらのプラグインの一部はライセンス可能な機能であり、スポーク実装の外部で使用する場合は適切なライセンスが必要です。

## 機能 {#spoke-builder__section_gdk_qmx_zxb}

統合ハブ のカスタムスポークにより、サードパーティのアプリケーションとのインバウンド統合とアウトバウンド統合の両方が実現します。この統合のことを「スポーク」と呼びます。スポークは、設定が簡単で、スクリプトを作成しなくても強力なアクションをすばやく追加することができます。この機能には、統合ハブ サブスクリプションが必要です。詳細については「[法務スケジュール - 統合ハブ の概要](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf)」を参照してください。

必要なサードパーティのアプリケーションにカスタムスポークをビルドするには、[OpenAPI 仕様](https://servicenow-prod.fluidtopics.net/tnCFYmt9WinYHQ~ld7h_5A "OpenAPI 仕様をインポートすることで、統合を自動化し、再利用可能なアクションを生成します。")または [Postman コレクション](https://servicenow-prod.fluidtopics.net/JcjlQhPoL8EXb8OoWiswEw "Postman Collection をインポートすることで、統合を自動化し、再利用可能なアクションを生成します。")、[サードパーティ API ドキュメントのドキュメントスニペット](https://servicenow-prod.fluidtopics.net/74E~aPs48NwPolepq7XpDA "スポークジェネレーターの Now Assist を使用して、必要なサードパーティ API ドキュメントスニペットを入力として提供することで、スポークとアクションを作成します。")をインポートするか、または[手動でスポークを作成](https://servicenow-prod.fluidtopics.net/tsmPYWt12RtpbJ93xPLBbA "統合を自動化し、再利用可能なアクションを手動で生成します。")します。

## 必要なユーザーロール {#spoke-builder__section_np1_3ky_byb}

* admin ロールを持つユーザーは、次の操作を実行できます。
  * \[スポーク\] タブを表示する。
  * 新規スポークを作成する。
  * OpenAPI 仕様をインポートする。
  * 接続エイリアスを作成する。
  * アクションを公開し、アクションをドラフトとして保存する。
  * スポークアクティビティログを確認する。
  {#spoke-builder__ul_qzw_bly_byb}
* action_designer および fd_read_actions ロールを持つユーザーは、次の操作を実行できます。
  * \[スポーク\] タブを表示する。
  * スポーク内アクションを表示する。
  {#spoke-builder__ul_z2v_tly_byb}
* action_designer ロールを持つユーザーは、アクションを手動で追加できます。  
  注:  
  fd_read_actions ロールのみを持つユーザーは、アクションの表示のみ可能です。
* flow_operator または flow_designer を持つユーザーは、フローとサブフローを表示できます。
{#spoke-builder__ul_btf_1ly_byb}

## OpenAPI 仕様のサイズの制限 {#spoke-builder__section_ssb_lmy_byb}

デフォルトでは、システムは最大 10 MB の OpenAPI 仕様をインポートできます。インポートサイズを増やすには、glide.rest.openapi.max_request_size システムプロパティを更新します。最大値は 100 MB です。

## OpenAPI 仕様の制限事項 {#spoke-builder__section_igf_l1g_dhb}

OpenAPI 仕様をインポートして作成されたスポークアクションには、OpenAPI ステップが含まれています。これらの OpenAPI ステップの制限事項を必ず確認してください。  

要求本文メディアタイプ
:   要求本文は、JSON のメディアタイプのみをサポートしています。  
    注:  
    OpenAPI スキーマに additionalProperties プロパティがある場合、またはプロパティがひとつもない場合は、文字列タイプの出力オブジェクトが作成されます。

OpenAPI 3.0 コンポーネント

:   OpenAPI 3.0 では、API をさらに詳細に記述するための新しいコンポーネントが Swagger 2.0 に追加されています。OpenAPI ステップの OpenAPI サポートは、これらのコンポーネントの一部をサポートしていますが、すべてをサポートしているわけではありません。現在、OpenAPI ステップはこれらのコンポーネントをサポートしていません。

    * スキーマオブジェクト：oneOf、anyOf、additionalProperties プロパティ
    * 識別子オブジェクト
    * 情報オブジェクト：termsOfService、連絡先、ライセンスフィールド
    * サンプルオブジェクト
    * リンクオブジェクト
    * コールバックオブジェクト
    * セキュリティスキームオブジェクト
    * セキュリティ要件オブジェクト
    * タグオブジェクト
    * 外部ドキュメントオブジェクト
    * サーバーオブジェクト
    * 仕様拡張
    * 再帰参照
    {#spoke-builder__ul_gtc_xbp_zhb}

    これらのコンポーネントの詳細については、OpenAPI ドキュメントを参照してください。「[OpenAPI 仕様](https://swagger.io/specification/)」を参照してください。

サポートされる操作の最大数
:   API 操作の数は、デフォルトで 500 に制限されています。ただし、システムプロパティ glide.rest.openapi.max_operation_limit を使用すると、操作の数を 1 ～ 1000 の範囲で設定できます。

## アプリバージョン {#spoke-builder__section_d34_kgj_zyb}

スポークジェネレーター v4.1.4 が最新バージョンです。
* **[OpenAPI 仕様のインポートによるスポークの作成とアクションのビルド](https://servicenow-prod.fluidtopics.net/tnCFYmt9WinYHQ~ld7h_5A)**   
  OpenAPI 仕様をインポートすることで、統合を自動化し、再利用可能なアクションを生成します。
* **[Postman Collection のインポートによるスポークの作成とアクションの構築](https://servicenow-prod.fluidtopics.net/JcjlQhPoL8EXb8OoWiswEw)**   
  Postman Collection をインポートすることで、統合を自動化し、再利用可能なアクションを生成します。
* **[Now Assist を使用してスポークを作成し、アクションをビルドする](https://servicenow-prod.fluidtopics.net/74E~aPs48NwPolepq7XpDA)**   
  スポークジェネレーターの Now Assist を使用して、必要なサードパーティ API ドキュメントスニペットを入力として提供することで、スポークとアクションを作成します。
* **[手動でのスポークの作成とアクションのビルド](https://servicenow-prod.fluidtopics.net/tsmPYWt12RtpbJ93xPLBbA)**   
  統合を自動化し、再利用可能なアクションを手動で生成します。
* **[カスタムスポークへのアクションの追加](https://servicenow-prod.fluidtopics.net/h8G~zlvvyS1v1w1w5ReU2A)**   
  再利用可能なアクションをカスタムスポークに追加して、統合を自動化します。