Box スポーク

  • リリースバージョン: Zurich
  • 更新日 2025年09月01日
  • 所要時間：12分

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

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。

    スポークバージョン

    ボックススポーク v3.4.0 が最新バージョンです。

    サポート対象のバージョン

    API バージョン v2。

    スポークの要件

    ServiceNow インスタンスと Box アカウントで同じ言語が選択されていることを確認してください。

    • ServiceNowインスタンスで、次の場所に移動して必要な言語を選択します ユーザープロファイル > 設定 > 表示.

      ServiceNow インスタンスで言語を設定します。

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

      Box アカウントで言語を設定します。

    スポークのフロー

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

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

    スポークのアクション

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

    カテゴリ アクション 説明
    ドキュメント管理 ファイルにメタデータを追加 指定された属性情報を Box ファイルのメタデータとして追加して保存します。
    ボックスファイルをレコードに添付 Box からファイルをコピーし、指定された ServiceNow レコードに添付します。
    ファイル ID を検索 Box の指定されたファイルの ID を取得します。
    所有アイテムを移動 Box の指定されたユーザーが所有するすべてのアイテムを、指定されたフォルダーに移動します。
    ファイルを削除 指定されたファイルを Box から削除します。
    コンテンツストリームを検索 ユーザーのコンテンツ全体または企業全体のファイル、フォルダー、Web リンク、および共有ファイルを検索します。
    ファイルをアップロード 指定されたファイルを Box にアップロードします。
    ドキュメント共有 協力者を追加 特定のファイルまたはフォルダーへの指定されたレベルのアクセス権をユーザーまたはグループに付与します。協力者には、次のいずれかのアクセスレベルがあります。
    • 共同オーナー
    • 編集者
    • プレビュー担当者
    • プレビューアップローダー
    • アップローダー
    • ビューアー
    • ビューアーアップローダー
    共有リンクを作成 Box 内のファイルまたはフォルダーへの読み取り専用の直接リンクを作成します。
    ID でフォルダー協力者を検索 指定したフォルダー ID に関連付けられているすべての協力者を取得します。
    協力者を削除 指定されたコラボレーションを Box のファイルまたはフォルダーから削除します。
    フォルダー管理 フォルダーを作成 指定された Box ユーザーアカウントの代わりに Box にフォルダーを作成します。
    フォルダーを削除 ボックス内の指定されたフォルダーを削除します。
    フォルダー ID を検索 Box の指定されたフォルダーの ID を取得します。
    注:
    Box に追加されたアイテムがアクセス可能になるまで 10 分かかります。たとえば、1 つのアクションでフォルダーが作成された場合、[フォルダー ID を検索] アクションは 10 分経過するまで結果を返しません。
    グループ管理 グループを作成 指定した招待設定で 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 を作成します。
    ID で Webhook を検索 指定された ID で Webhook を取得します。
    Webhook ストリームを検索 指定されたアプリケーションに定義されているすべての Webhook を取得します。
    Webhook を削除 Webhook を削除します。
    Webhook を更新 Webhook を更新します。

    利用可能な AI エージェント

    Now Assist for スポークをインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「Now Assist for スポーク」を参照してください。

    このスポークは、人間のような知能を模倣して ServiceNow インスタンスでタスクを実行するスタンドアロンの AI エージェントを提供します。
    • ServiceNowエージェントシステムでは、目標を実行するために、一連の大規模言語モデル (LLM) 命令と 1 つ以上のスタンドアロン AI エージェントで構成されるエージェントワークフローを作成できます。AI エージェントを追加して要件に従ってエージェントワークフローを作成し、必要なトリガーを提供する方法については、 Create an agentic workflow を参照してください。

      他の利用可能な AI エージェントを検索して、エージェントワークフローに追加することもできます。詳細については、「Find AI agents」を参照してください。

    • 必要なスポーク AI エージェントのクローンを作成し、要件に応じてカスタマイズできます。クローンの作成の詳細については、 Duplicate an AI agent を参照してください。
    • AI エージェントの詳細については、 Now Assist AI agents を参照してください。
    利用可能な AI エージェントは次のとおりです。
    AI エージェント 説明
    Box ユーザー管理 AI エージェント Box でユーザー管理タスクを管理します (グループへのユーザーの追加、ユーザーの有効化、ユーザーの作成、ユーザーの削除、ユーザーの更新、ユーザー ID の検索、ユーザーの無効化)。
    Box フォルダー管理 AI エージェント Box のフォルダー管理タスク (フォルダーの作成、フォルダー ID のルックアップ、フォルダーの削除) を管理します。
    Box ドキュメント共有 AI エージェント

    Box でドキュメント共有タスク (協力者の削除、協力者の追加、共有リンクの作成、ID によるフォルダー協力者の検索) を管理します。
    Box グループ管理 AI エージェント Box でグループ管理タスク (グループの更新、グループの作成、グループの削除) を管理します。
    Box メタデータ管理 AI エージェント Box でメタデータ取得タスク (スコープとテンプレートキーでファイルのメタデータインスタンスを検索する、フォルダー ID でフォルダーのメタデータインスタンスを検索する、スコープとテンプレートキーでフォルダーのメタデータインスタンスを検索する、ファイル ID でファイルのメタデータインスタンスを検索する) を管理します。
    Box 保持ポリシー管理 AI エージェント Box で保持ポリシー管理タスク (保持ポリシーの更新、保持ポリシーストリームの検索、ID による保持ポリシーアサインの検索、ID による保持ポリシーの検索、保持ポリシーアサインストリームの検索) を管理します。
    Box ドキュメント管理 AI エージェント ドキュメント管理タスクを Box で管理 (ファイルの削除、Box ファイルのレコードへの添付、ファイルのアップロード、所有アイテムの移動、コンテンツストリームの検索、ファイル ID の検索、ファイルへのメタデータの追加) を行います。
    Box 訴訟ホールド管理 AI エージェント Box で訴訟ホールド管理タスク (訴訟ホールドポリシーの作成、ID による訴訟ホールドポリシーアサインの検索、訴訟ホールドポリシーの更新、すべての訴訟ホールドポリシーストリームの検索、ID による訴訟ホールドポリシーの検索、訴訟ホールドポリシーのアサイン解除、訴訟ホールドポリシーの削除、訴訟ホールドポリシーアサインストリームの検索) を管理します。
    AI エージェントをお探しですか?
    • Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。インスタンスで利用可能なすべてのエージェントを表示する方法については、「 AI エージェントの検索」を参照してください。
    • インスタンスにインストールされていない可能性のあるエージェントを見つけるには、ServiceNow Store の AI エージェントマーケットプレイスにアクセスしてください。
    注:
    AI エージェントを実行しているユーザーに、AI エージェントに関連付けられたテーブル内のデータにアクセスしたり、データに対して操作を実行したりするために必要なロールと権限があることを確認します。

    Box スポークモジュール

    双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。Webhook レジストリは、ServiceNow アプリに通知するために満たすべき条件を定義しています。これらの条件は、通知を受けたい Box のイベントに基づいています。条件が満たされると、指定されたトリガー名が関連するサブフローをトリガーし、Box タスクを自動化します。

    Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。Box スポークは Box スポークアプリケーションをインスタンスに追加し、以下のモジュールを含めます。
    表 : 1. Box モジュール
    モジュール 説明
    Box Webhook レジストリ ServiceNow で Plivo Webhook を作成および表示します。
    訴訟ホールドポリシー 利用可能な Box の訴訟ホールドポリシーのリストを表示します。
    保持ポリシー 利用可能な Box の保持ポリシーのリストを表示します。

    Box アカウント要件

    ボックススポーク では、Box アカウントでカスタムアプリを作成し、OAuth 2.0 トークンを生成する必要があります。「OAuth アプリケーションの作成」を参照してください。

    接続および資格情報エイリアスの要件

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

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

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

    スポーク接続エイリアスを使用するには、エイリアスごとに関連付けられた接続レコードと関連付けられた認証情報レコードを作成します。スポークの設定については、「 Box スポークの設定。