外部システムのスポークセレクターの構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:6分
  • Aria のスポークセレクターを構成して、請求要求の構成と実行を有効にします。

    始める前に

    必要なロール:admin

    このタスクについて

    スポークセレクターアプリケーションは、統合要求の構成と実行を可能にする共通フレームワークを提供します。これは、各要求に設定された入力パラメーターに基づいて一致する実装を選択することによって動作します。

    手順

    1. 移動先 すべて > スポークセレクター > 要求タイプ.
    2. [請求要求] を選択します。

      請求要求は、Aria API を呼び出す要求定義で構成されます。このデモ実装は、請求処理要求のためにサードパーティシステムから請求処理関連データを取得する新しい要求定義を構成するための参照として機能します。

    3. 統合要求定義を作成します。

      Order に適切な値を指定するか、選択条件を定義することで、請求関連データをフェッチする新しい要求定義がトリガーされます。

    4. 統合要求定義を作成するには、次に移動します: すべて > スポークセレクター > 要求定義.
    5. [統合要求定義] 画面で、ヘッダーセクションの [新規 ] を選択します。
      [統合要求定義] 画面
    6. フォームで、フィールドに入力します。
      表 : 1. 統合要求タイプフォーム
      フィールド 説明
      名前 統合要求タイプの名前。
      タイプ 統合要求タイプとして請求要求が選択されます。
      説明 要求定義の簡単な説明。
      順序 要求定義は最小順序の値で実行されます。
      アダプタタイプ フロー
      要求アダプタ それぞれの構成タイプのレコードをフェッチするように構成されたフローの名前。
      注:
      正しいフロー入力、フロー出力、およびフロースナップショットを含むsys_hub_flowレコード。
      アプリケーション アプリケーションの詳細を保存します。
      ドメイン グローバル
      条件 要求アダプターをトリガーする条件。
      次のパラメータは、Get Account Details Request for Aria API リクエストアダプタのリクエストに含める必要があります。
      
      {"api_name":"get_acct_details","request_body":{"client_acct_id":"FT0010001"}}
      
      次のパラメータは、Aria API のアカウント詳細応答の取得 API リクエストアダプタの応答に含める必要があります。
      {"status_code":"1","status_reason":"","response_body":{"master_plan_info_list":{"48477095":"Business Internet + 
                 Cellphone PI0001061"},"company_name":"Flash Telecom","acct_no":"27045400"}}
      次のパラメータは、Get Invoice History Request for Aria API リクエストアダプタのリクエストに含める必要があります。
      {"api_name":"get_invoice_history","request_body":{"acct_no":"27045400"}}
      
      Get Invoice History Response for Aria API リクエストアダプタのレスポンスには、次のパラメータを含める必要があります。
      {"status_code":"1","status_reason":"","response_body":{"invoices":
      [{"amount":135.7,"invoice_no":254547358,"due_date":"2024-11-
      30","outstanding_amount":135.7,"usage_bill_from":"2024-10-01","usage_bill_thru":"2024-10-31"},
      {"amount":190.26,"invoice_no":254547359,"due_date":"2024-12-
      31","outstanding_amount":190.26,"usage_bill_from":"2024-11-01","usage_bill_thru":"2024-11-30"},
      {"amount":172.95,"invoice_no":254547360,"due_date":"2025-01-
      31","outstanding_amount":172.95,"usage_bill_from":"2024-12-01","usage_bill_thru":"2024-12-31"},
      {"amount":437.07,"invoice_no":254547361,"due_date":"2025-02-
      28","outstanding_amount":0,"usage_bill_from":"2025-01-01","usage_bill_thru":"2025-01-31"}]}}
      Get Invoice Details Request for Aria API リクエストアダプタのリクエストには、次のパラメータを含める必要があります。
      {"api_name":"get_invoice_details","request_body":{"acct_no":"27045400","invoice_no":"254547361"}}
      
      次のパラメーターは、Aria API の請求書の詳細応答を取得 (Get Invoice Details Response for Aria API request) アダプターの応答に含める必要があります。
      {"status_code":"1","status_reason":"","response_body":{"line_items":
      [{"usage_type_no":10058138,"amount":0,"service_name":"Mobile Data
      GB","sold_product_number":"PI0001065","service_no":11196572,"description":"Mobile Data GB (10 gigabytes @
      $0)"},{"usage_type_no":10058138,"amount":14.35,"service_name":"Mobile Data
      GB","sold_product_number":"PI0001065","service_no":11196572,"description":"Mobile Data GB (18.847 gigabytes
      @ $1)"},{"usage_type_no":10058140,"amount":255.73,"service_name":"International Roaming Calls from
      EU","sold_product_number":"PI0001065","service_no":11197966,"description":"International Roaming Calls from
      EU (93 minutes @ $2.75)"},{"usage_type_no":10058144,"amount":0.5,"service_name":"Domestic
      Minutes","sold_product_number":"PI0001065","service_no":11196568,"description":"Domestic Minutes (9.91
      minutes @ $.05)"},{"usage_type_no":10058146,"amount":11.75,"service_name":"International Calls to
      Asia","sold_product_number":"PI0001065","service_no":11196570,"description":"International Calls to Asia (6.56
      minutes @ $1.79)"}]}}
    7. [Save (保存)] を選択します。

    タスクの結果

    条件が設定され、要求条件が一致すると、定義されたフローが実行され、構成のレコードが選択した外部プロバイダーから ServiceNow インスタンスにフェッチされます。