---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Box スポーク

# Box スポーク {#ariaid-title1}

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

共有ドキュメントとして管理できるように添付ファイルをボックスに移動します。

## ストアでアプリを要求する {#box-spoke__section_gw5_x2f_mjb}

[ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「[ServiceNow Storeバージョン履歴のリリースノート](https://docs.servicenow.com/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html)」を参照してください。{#box-spoke__inline-send-to-store}

## 統合ハブサブスクリプション {#box-spoke__section_rsf_yvb_l3b}

このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「[法務スケジュール - 統合ハブの概要](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf)」を参照てください。

## スポークバージョン {#box-spoke__section_yf2_tdv_bsb}

ボックススポーク v3.6.0 が最新バージョンです。{#box-spoke__box-ver}

## サポートされているバージョン {#box-spoke__section_zjt_sh4_zgb}

API バージョン v2。

## スポークの要件 {#box-spoke__section_tb5_ymx_p1c}

ServiceNow インスタンスと Box アカウントで同じ言語が選択されていることを確認してください。  
* ServiceNowインスタンスで、次のものに移動して必要な言語を選択します ユーザープロファイル設定表示.

* Box アカウントで、次の場所に移動して必要な言語を選択します アカウント設定アカウント一般的なオプション.

{#box-spoke__ul_khm_znx_p1c}

## スポークのフロー {#box-spoke__section_y1q_3h4_gfb}

ボックススポークでは、Box タスクの自動化をデモするドラフト状況のサンプルフローが提供されます。サンプルフローをカスタマイズするには、新しいアプリケーションスコープにコピーします。利用可能なサンプルフローは次のとおりです。  
{#box-spoke__table_q45_mh4_gfb__entry__2}

| フロー | 説明 |
|-|-|
| 作成時に添付ファイルを Box に移動 (Move Attachment when created to Box) | 新しい添付ファイルレコードの追加時に添付ファイルを ServiceNow から Box に移動します。Box で移動された添付ファイルへの共有リンクでトリガーレコードを更新します。 |
| オンボーディングユーザー (On-boarding user) | Box ユーザーグループに ServiceNow ユーザーを作成すると、Box にユーザーが作成されます。 |
[ ]

{#box-spoke__table_q45_mh4_gfb}

## スポークのアクション {#box-spoke__section_zqb_zzn_gfb}

ボックススポーク は、ServiceNow でイベントが発生したときに Box タスクを自動化するアクションを提供します。使用可能なアクションは次のとおりです。  
{#box-spoke__table_qpz_ktb_x2b__entry__3}

| カテゴリ | アクション | 説明 |
|-|-|-|
| Box AI 管理 | 質問する | 指定されたコンテキストを使用してサポートされている AI モデルにプロンプトを送信し、ユーザーの質問に焦点を当てた簡単な回答を返します。 |
| Box AI 管理 | メタデータの抽出フリーフォーム | サポートされている AI モデルにコンテキストに応じた要求を送信し、メタデータを構造化されたキーと値のペアとして抽出します。 |
| Box AI 管理 | AI エージェントのデフォルト構成を検索 | 指定された AI エージェントのデフォルトの構成設定を取得します。 |
| Box Hub 管理 | ID で Box Hub 情報を検索 | 指定されたハブ ID を使用して Box Hub の詳細を取得します。 |
| Box Hub 管理 | Box Hub アイテムストリームを検索 | 指定された Box Hub に関連付けられているすべてのアイテムを取得します。 |
| Box Hub 管理 | Box Hubs ストリームを検索 | アクセストークンの生成に使用されたボックス認証情報に基づいて、要求ユーザーが利用できるすべてのボックスハブを取得します。 |
| ドキュメント管理 | ファイルにメタデータを追加 | 指定された属性情報をボックスファイルのメタデータとして追加することにより、保存します。 |
| ドキュメント管理 | ボックスファイルをレコードに添付 | Box からファイルをコピーし、指定された ServiceNow レコードに添付します。 |
| ドキュメント管理 | ファイル ID を検索 | Box の指定されたファイルの ID を取得します。 |
| ドキュメント管理 | 所有アイテムを移動 | Box の指定されたユーザーが所有するすべてのアイテムを、指定されたフォルダーに移動します。 |
| ドキュメント管理 | ファイルを削除 | 指定されたファイルを Box から削除します。 |
| ドキュメント管理 | コンテンツストリームを検索 | ユーザーのコンテンツ全体または企業全体のファイル、フォルダー、Web リンク、および共有ファイルを検索します。 |
| ドキュメント管理 | ファイルをアップロード | 指定されたファイルを Box にアップロードします。 |
| ドキュメント管理 | アーカイブストリームを検索 | ボックスアプリケーションから利用可能なすべてのアーカイブを取得します。 |
| ドキュメント共有 | 協力者を追加 | 特定のファイルまたはフォルダーへの指定されたレベルのアクセス権をユーザーまたはグループに付与します。協力者には、次のいずれかのアクセスレベルがあります。 * 共同オーナー * エディター * プレビュー担当者 * プレビューアップローダー * アップローダー * ビューアー * ビューアーアップローダー {#box-spoke__ul_ybd_n5b_x2b} |
| ドキュメント共有 | 共有リンクを作成 | Box 内のファイルまたはフォルダーへの読み取り専用の直接リンクを作成します。 |
| ドキュメント共有 | ID でフォルダー協力者を検索 | 指定したフォルダー ID に関連付けられているすべての協力者を取得します。 |
| ドキュメント共有 | 協力者を削除 | 指定されたコラボレーションを Box のファイルまたはフォルダーから削除します。 |
| ファイル管理 | ファイル情報を検索 | 指定されたファイルの詳細情報を取得します。 |
| フォルダー管理 | フォルダーを作成 | 指定された Box ユーザーアカウントの代わりに Box にフォルダーを作成します。 |
| フォルダー管理 | フォルダーを削除 | ボックス内の指定されたフォルダーを削除します。 |
| フォルダー管理 | フォルダー ID を検索 | Box の指定されたフォルダーの ID を取得します。 注: Box に追加されたアイテムがアクセス可能になるまで 10 分かかります。たとえば、1 つのアクションでフォルダーが作成された場合、\[フォルダー ID を検索\] アクションは 10 分経過するまで結果を返しません。 |
| フォルダー管理 | フォルダー情報を検索 | 指定したフォルダーの詳細を取得します。 |
| フォルダー管理 | フォルダーアイテムストリームを検索 | ファイル、サブフォルダー、Web リンクなど、指定されたフォルダー内のすべてのアイテムを取得します。 |
| グループ管理 | グループの作成 | 指定した招待設定で Box にグループを作成します。 |
| グループ管理 | グループを削除 | Box の指定されたグループを削除します。 |
| グループ管理 | グループを更新 | Box の指定されたグループを指定された設定で更新します。 |
| 訴訟ホールド管理 | 訴訟ホールドポリシーをアサイン | 訴訟ホールドポリシーをファイル、ファイルバージョン、フォルダー、またはユーザーにアサインします。 |
| 訴訟ホールド管理 | 訴訟ホールドポリシーを作成 | 訴訟ホールドポリシーを作成します。 |
| 訴訟ホールド管理 | すべての訴訟ホールドポリシーストリームを検索 | 企業の訴訟ホールドポリシーのリストを取得します。 |
| 訴訟ホールド管理 | ID で訴訟ホールドポリシーのアサインを検索 | 指定された ID の訴訟ホールドポリシーのアサインを取得します。 |
| 訴訟ホールド管理 | 訴訟ホールドポリシーアサインストリームを検索 | 訴訟ホールドポリシーにアサインされているアイテムのリストを取得します。 |
| 訴訟ホールド管理 | ID で訴訟ホールドポリシーを検索 | 指定された ID の訴訟ホールドポリシーを取得します。 |
| 訴訟ホールド管理 | 訴訟ホールドポリシーを削除 | 既存の訴訟ホールドポリシーを削除します。 |
| 訴訟ホールド管理 | 訴訟ホールドポリシーのアサインを解除 | 訴訟ホールドへのアイテムのアサインを削除します。 |
| 訴訟ホールド管理 | 訴訟ホールドポリシーを更新 | 訴訟ホールドポリシーを更新します。 |
| メタデータ管理 | ファイル ID でファイルのメタデータインスタンスを検索 | 指定されたファイル ID を持つファイルのメタデータインスタンスを取得します。 |
| メタデータ管理 | スコープとテンプレートキーでファイルのメタデータインスタンスを検索 | 指定されたスコープとテンプレートキーを持つフォルダーのメタデータインスタンスを取得します。 |
| メタデータ管理 | フォルダー ID でフォルダーのメタデータインスタンスを検索 | 指定されたフォルダー ID を持つフォルダーのすべてのメタデータを取得します。 注: フォルダー ID 値がゼロのルートフォルダーではこのアクションを使用しないでください。 |
| メタデータ管理 | スコープとテンプレートキーでフォルダーのメタデータインスタンスを検索 | 指定されたスコープとテンプレートキーを持つフォルダーのすべてのメタデータを取得します。 |
| メタデータ管理 | メタデータストリームでファイルまたはフォルダーを照会 | SQL のような構文を使用してファイルまたはフォルダーを検索し、一致する結果を返します。 |
| 保持ポリシー管理 | 保持ポリシーをアサイン | アイテムに保持ポリシーをアサインします。 |
| 保持ポリシー管理 | 保持ポリシーを作成 | 保持ポリシーを作成します。 |
| 保持ポリシー管理 | 保持ポリシーを検索 (Look up Retention Policies) | エンタープライズのすべての保持ポリシーを取得します。 |
| 保持ポリシー管理 | ID で保持ポリシーのアサインを検索 | 指定された ID で保持ポリシーを取得します。 |
| 保持ポリシー管理 | 保持ポリシーアサインストリームを検索 | 指定された保持ポリシーに関連付けられているすべての保持ポリシーアサインのリストを返します。 |
| 保持ポリシー管理 | ID で保持ポリシーを検索 | 指定された ID で保持ポリシーを取得します。 |
| 保持ポリシー管理 | 保持ポリシーを更新 | 保持ポリシーを更新します。 |
| ユーザー管理 | グループにユーザーを追加 | 指定されたユーザーを Box の指定されたグループに追加します。 |
| ユーザー管理 | ユーザーの作成 | Box にユーザーアカウントを作成します。 |
| ユーザー管理 | ユーザーを削除 | Box の指定されたユーザーを削除します。 |
| ユーザー管理 | ユーザーを無効化 | Box の指定されたユーザーのステータスを非アクティブに設定します。 |
| ユーザー管理 | ユーザーを有効化 | Box の指定されたユーザーのステータスをアクティブに設定します。 |
| ユーザー管理 | ユーザー ID を検索 | Box の指定されたユーザーの ID を取得します。 |
| ユーザー管理 | ユーザーを更新 | Box の指定されたユーザーを指定されたロール変更で更新します。 |
| Webhook 管理 | Webhook を作成 | Webhook を作成します。 |
| Webhook 管理 | ID で Webhook を検索 | 指定された ID で Webhook を取得します。 |
| Webhook 管理 | Webhook ストリームを検索 | 指定されたアプリケーションに定義されているすべての Webhook を取得します。 |
| Webhook 管理 | Webhook を削除 | Webhook を削除します。 |
| Webhook 管理 | Webhook を更新 | Webhook を更新します。 |
[ ]

{#box-spoke__table_qpz_ktb_x2b}

## スポークのトリガー {#box-spoke__section_qx5_3sj_mhc}

ServiceNow は、トリガーを作成する Box 上の特定のイベントをサポートしています。最初に、サポートされているトリガー定義を含むフローを構成する必要があります。プッシュ要求などのイベントが Box で発生すると、Webhook を介してペイロードが ServiceNow インスタンスに送信されます。その後、ワークフローを自動化するために構成したフローが ServiceNow インスタンスでトリガーされます。サポートされているイベントは次のとおりです。  
{#box-spoke__table_cjy_lsj_mhc__entry__3}

| カテゴリ | トリガー | 説明 |
|-|-|-|
| ファイル管理 | ダウンロードされたファイル | ファイルがダウンロードされると、フローがトリガーされます。 |
| ファイル管理 | ファイルがロックされています | ファイルがロックされると、フローがトリガーされます。 |
| ファイル管理 | ファイルが移動されました | ファイルが移動されるとフローがトリガーされます。 |
| ファイル管理 | ファイル名が変更されました | ファイルの名前が変更されると、フローがトリガーされます。 |
| ファイル管理 | ファイルのロック解除完了 | ファイルのロックが解除されると、フローがトリガーされます。 |
| ファイル管理 | ファイルのアップロード | ファイルがアップロードされると、フローがトリガーされます。 |
| フォルダー管理 | フォルダーの作成日時 | フォルダーが作成されると、フローがトリガーされます。 |
| フォルダー管理 | フォルダーのダウンロード完了 | フォルダーがダウンロードされると、フローがトリガーされます。 |
| フォルダー管理 | フォルダーが移動されました | フォルダーが移動されるとフローがトリガーされます。 |
| フォルダー管理 | フォルダーの名前が変更されました | フォルダーの名前が変更されると、フローがトリガーされます。 |
[ ]

{#box-spoke__table_cjy_lsj_mhc}

Box スポークのトリガーの設定については、「 [Box スポークのトリガーの設定](https://servicenow-prod.fluidtopics.net/TomGhoH0~K~4x2LP8vLBcw#box-spk-triggers-setup "ServiceNow インスタンスでシークレットとコールバック URL を生成するトリガーを設定します。")」を参照してください。インバウンド統合の詳細については、「[条件付きおよびイベント駆動型のインバウンド統合](https://servicenow-prod.fluidtopics.net/3P3izYcM1QEA~a~cEi5EsQ "統合ハブ では、サードパーティアプリケーションとの条件付きおよびイベント駆動型の両方のインバウンド統合が可能です。")」を参照してください。

## スポークユーザーロール {#box-spoke__section_mf3_kk5_whc}

次のユーザーロールはスポークで利用可能です。

* ポリシーユーザー (sn_box_spoke.box_policies_user):このロールを持つユーザーは 、保持ポリシー モジュールにのみアクセスできます。
* 訴訟ホールドポリシーユーザー (sn_box_spoke.legal_hold_policy_user):このロールを持つユーザーは 、訴訟ホールドポリシー モジュールにのみアクセスできます。
* Box Webhook レジストリユーザー (sn_box_spoke.box_webhook_registry_user):このロールを持つユーザーは、 Box Webhook レジストリ モジュールにのみアクセスできます。
{#box-spoke__ul_rk3_mk5_whc}

## Box スポークモジュール {#box-spoke__section_v4c_1f5_fpb}

双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。Webhook レジストリは、ServiceNow アプリに通知するために満たすべき条件を定義しています。これらの条件は、通知を受けたい Box のイベントに基づいています。条件が満たされると、指定されたトリガー名が関連するサブフローをトリガーし、Box タスクを自動化します。  
Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。Box スポークは Box スポークアプリケーションをインスタンスに追加し、以下のモジュールを含めます。{#box-spoke__table_oqb_kf5_fpb__entry__2}

| モジュール | 説明 |
|-|-|
| Box Webhook レジストリ | ServiceNow で Box Webhook を作成および表示します。 |
| 訴訟ホールドポリシー | 利用可能な Box の訴訟ホールドポリシーのリストを表示します。 |
| 保持ポリシー | 利用可能な Box の保持ポリシーのリストを表示します。 |
[表 : 1. Box モジュール]

{#box-spoke__table_oqb_kf5_fpb}

## Box アカウント要件 {#box-spoke__section_fgv_rxg_gfb}

ボックススポーク では、Box アカウントでカスタムアプリを作成し、OAuth 2.0 トークンを生成する必要があります。「[OAuth アプリケーションの作成](https://servicenow-prod.fluidtopics.net/BIUyTAg9n998RrEDFqMNeA#configure-box-account "ボックスアカウントからカスタム OAuth アプリケーションを作成し、ボックススポークで OAuth 2.0 認証を有効にします。")」を参照してください。

## 接続および資格情報エイリアスの要件 {#box-spoke__section_plx_qxg_gfb}

統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。

このスポークでは以下のエイリアスレコードを使用してアクションを許可します。  
{#box-spoke__table_nnk_g2h_gfb__entry__3}

| 接続および資格情報エイリアス | 説明 | 接続エイリアスの要件 |
|-|-|-|
| ボックス | Box コラボレーション API とファイル管理 API への接続 | * 接続タイプ：HTTP * 接続 URL：https://api.box.com {#box-spoke__ul_atz_rsl_kfb} |
| Box アップロード (Box Upload) | Box アップロードサービスへの接続。 | * 接続タイプ：HTTP * 接続 URL：https://upload.box.com {#box-spoke__ul_z2p_xsl_kfb} |
[ ]

{#box-spoke__table_nnk_g2h_gfb}

スポーク接続エイリアスを使用するには、エイリアスごとに関連付けられた接続レコードと関連付けられた認証情報レコードを作成します。スポークの設定については、「 [Box スポークの設定](https://servicenow-prod.fluidtopics.net/BIUyTAg9n998RrEDFqMNeA#setup-box-spoke "ServiceNow インスタンスと Box API を統合して、Box スポークアクションを自動化します。たとえば、Box アカウントのファイルを削除するフローを設定することができます。Box スポークを設定すると、このフローは自動化されます。")。