PESQUISE informações remotas no sistema de registro

Este caso de uso ilustra como usar uma chamada da REST API para pesquisar detalhes da transação financeira da conta hipotecária de um cliente em um sistema bancário remoto (sistema de registro).

Um agente do call center responde a uma consulta do cliente e cria um novo caso de FSO usando um ServiceNowformulário. Nesse formulário, eles inserem manualmente as informações do consumidor, conta financeira, categoria e descrição resumida e todas as anotações associadas.

Usando as informações da conta financeira e do consumidor, um script no ServiceNowO formulário chama um endpoint REST remoto no sistema bancário remoto (aplicação bancária) para obter os detalhes da transação financeira. Em seguida, ele exibe esses detalhes no ServiceNowpara que o agente possa verificar as informações antes de inserir manualmente o restante das informações de caso necessárias. Quando concluído, o caso de FSO é armazenado em cache no ServiceNowinstância.

Nota:

Este caso de uso presume que a aplicação do banco expõe o endpoint REST OBTENHA /api/getTransactions que retorna os detalhes do consumidor solicitados e sua conta financeira associada.

A seguir, há um exemplo de como os detalhes da transação financeira recebidos da aplicação bancária remota podem ser quando aparecem no formulário de caso de FSO:

O diagrama a seguir mostra o fluxo da aplicação para este cenário de caso de uso e fornece breves observações sobre qualquer processamento necessário. Nesta implementação, os dados obtidos da aplicação do banco remoto são armazenados em tabelas remotas. Tabelas remotas são armazenados em cache somente na memória, nunca são armazenados em ServiceNowtabelas de banco de dados. Você também pode implementar esse cenário gravando os dados remotos no correspondente ServiceNowtabelas de banco de dados. . s o cenário ilustra como armazenar dados no ServiceNowtabelas de banco de dados usando GlideRecord API.

O agente insere as informações necessárias no formulário FSO. Usando essas informações, formule a chamada REST /api/getTransactions usando o. RESTMessageV2 E envie-a para a aplicação bancária remota para obter os detalhes da transação financeira do cliente. A aplicação bancária remota processa a solicitação e retorna os detalhes da transação financeira do cliente especificado. Os detalhes da transação financeira são armazenados em cache no ServiceNowinstância em tabelas remotas usando tabela_v API. Os detalhes da transação são exibidos no formulário FSO.

Código de exemplo

O exemplo de código a seguir mostra como usar o. RESTMessageV2 API para criar e executar a chamada REST para a aplicação bancária externa. Em seguida, armazena os resultados de retorno em A. tabela remota usando o. tabela_v API. Antes de poder usar o. tabela_v API Você deve ativar o plug-in Tabelas remotas (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);

Código de exemplo

O exemplo de código a seguir mostra como consultar uma tabela remota e exibi-la no formulário 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();