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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分
  • このユースケースでは、REST API コールを使用して、リモートバンキングシステム (SoR (SoR) で顧客の住宅ローン口座の金融トランザクションの詳細を検索する方法を示します。

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

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

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

    リモート銀行の記録システムで金融取引の詳細をルックアップする方法を示すワークフロー。

    リモート銀行アプリケーションから受信した金融取引の詳細が FSO ケースフォームに表示される場合、次の例は次のようになります。

    リモート銀行アプリケーションから受信したトランザクションの詳細を示す FSO ケースフォーム。

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

    エージェントが必要な情報を入力し、REST API コールを使用してリモートバンキングシステムで金融取引の詳細を検索するケースを示すワークフロー。
    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();