SoR 内のリモート情報をルックアップ

  • リリースバージョン: Australia
  • 更新日 2025年07月31日
  • 所要時間:5分
  • このユースケースでは、REST API 呼び出しを使用して、リモートの銀行システム (記録システム) で顧客の住宅ローン口座の財務トランザクションの詳細を検索する方法を示します。

    コールセンターエージェントは、顧客からの問い合わせに応答し、 ServiceNow フォームを使用して新しい FSO ケースを作成します。そのフォームで、コンシューマー、金融口座、カテゴリ、簡単な説明の情報、および関連するメモを手動で入力します。

    ServiceNowフォーム内のスクリプトは、コンシューマーと金融口座の情報を使用して、リモートバンキングシステム (銀行アプリケーション) のリモート REST エンドポイントを呼び出して、財務トランザクションの詳細を取得します。エージェントが残りの必要なケース情報を手動で入力する前に情報を確認できるように、これらの詳細が ServiceNow フォームに表示されます。完了すると、FSO ケースが ServiceNow インスタンスにキャッシュされます。

    注:
    このユースケースでは、銀行アプリケーションが、要求されたコンシューマーの詳細とそれに関連する金融口座を返す REST エンドポイント GET /api/getTransactions を公開することを前提としています。

    リモート銀行アプリケーションから受信した財務トランザクションの詳細が FSO ケースフォームに表示されたときにどのように表示されるかの例を次に示します。

    次の図は、このユースケースシナリオのアプリケーションフローを示し、必要な処理について簡単に説明します。この実装では、リモートバンクアプリケーションから取得したデータはリモートテーブルに保存されます。リモートテーブル はメモリにのみキャッシュされ、 ServiceNow データベーステーブルには格納されません。このシナリオは、リモートデータを対応する ServiceNow データベーステーブルに書き込むことで実装することもできます。シナリオは、GlideRecord API を使用して ServiceNow データベーステーブルにデータを格納する方法を示しています。

    1. エージェントは、FSO フォームに必要な情報を入力します。この情報を使用して、RESTMessageV2 API を使用して REST 呼び出し /api/getTransactions を作成し、それをリモート銀行アプリケーションに送信して、顧客の金融取引の詳細を取得します。
    2. リモート銀行アプリケーションは要求を処理し、指定された顧客の金融取引の詳細を返します。
    3. 財務トランザクションの詳細は、v_table API を使用してリモートテーブルのServiceNowインスタンスにキャッシュされます。
    4. トランザクションの詳細が FSO フォームに表示されます。

    コード例

    次のコード例は、 RESTMessageV2 API を使用して外部銀行アプリケーションへの REST 呼び出しを作成して実行する方法を示しています。次に、v_table API を使用して返された結果をリモートテーブルに格納します。v_table API を使用する前に、リモートテーブル (com.glide.script.vtable) プラグインをアクティブ化する必要があります。
    (function executeQuery (v_table, v_query) {
    // Parameters needed in the request body of the REST endpoint
      var requestBody = {
        'financial_account':v_query.getParameter('financial_account')
      };
    
      // Instantiate the RESTMessageV2 object
      var request = new sn_ws.RESTMessageV2();
      // Set the HTTP method as "GET"
      request.setHttpMethod('get');
      // URL of the endpoint on the bank application
      request.setEndpoint('https://<yourbankapphost>/api/getTransactionDetails');
      // Request body as a string
      request.setRequestBody(JSON.stringify(requestBody));
      // Call the REST endpoint
      var response = request.execute();
      // Get the response body
      var responseBody = response.getBody();
      // Parse the response body into an object
      var responseObj = JSON.parse(responseBody);
    
      // Store the response body into a virtual table
      v_table.addRow({
        sys_id: gs.generateGUID(),
        amount: responseObj.amount,
        description: responseObj.description,
        posting_date: responseObj.posting_date,
        transaction_date: responseObj.transaction_date
      });
    
    }) (v_table, v_query);

    コード例

    次のコード例は、リモートテーブルにクエリを実行して FSO フォームに表示する方法を示しています。
    function getRequiredInfo() {
    
      // Instantiate a GlideRecord object with the remote table containing the financial transaction details.
      var now_GR = new GlideRecord('transaction_details_remote_table');
    
      // Create a query to obtain the desired financial account
      now_GR.addQuery('financial_account', g_form.getValue('financial_account'));
    
      // Execute the query
      var result = now_GR.query(); 
    
      // Display the data in the FSO form
      var data = [];
      data ['amount'] = result.amount;
      data ['description'] = result.description;
      data ['posting_date'] = result.posting_date;
      data ['transaction_date'] = result.transaction_date;
    
      return data;
    }
    
    getRequiredInfo();