Suchen Sie im Datensatzsystem nach Remote-Informationen

Dieser Anwendungsfall veranschaulicht, wie ein REST-API-Aufruf verwendet wird, um Finanztransaktionsdetails für das Hypothekenkonto eines Kunden in einem Remote-Banksystem (Datensatzsystem) zu suchen.

Ein Callcenter-Service Desk-Mitarbeiter beantwortet eine Kundenanfrage und erstellt einen neuen FSO-Fall mithilfe von ServiceNowFormular. In diesem Formular geben sie die Informationen zu Verbraucher, Finanzkonto, Kategorie und Kurzbeschreibung sowie alle zugehörigen Notizen manuell ein.

Unter Verwendung der Verbraucher- und Finanzkontoinformationen ein Skript in ServiceNowDas Formular ruft einen Remote-REST-Endpunkt im Remote-Banksystem (Bankanwendung) auf, um die Details der Finanztransaktion abzurufen. Dann werden diese Details in angezeigt ServiceNowFormular, damit der Service Desk-Mitarbeiter die Informationen überprüfen kann, bevor er die verbleibenden erforderlichen Fallinformationen manuell eingibt. Nach Abschluss wird der FSO-Fall auf zwischengespeichert ServiceNowInstanz.

Hinweis:

Dieser Anwendungsfall setzt voraus, dass die Bankanwendung den REST-Endpunkt verfügbar macht RUFT /api/getTransactions AB Gibt die angeforderten Verbraucherdetails und das zugehörige Finanzkonto zurück.

Im Folgenden finden Sie ein Beispiel dafür, wie die Finanztransaktionsdetails, die von der Remote-Bankanwendung empfangen wurden, aussehen könnten, wenn sie im FSO-Fallformular angezeigt werden:

Das folgende Diagramm zeigt den Anwendungs-Flow für dieses Anwendungsfallszenario und enthält kurze Anmerkungen zur erforderlichen Verarbeitung. In dieser Implementierung werden die von der Remote-Bank-Anwendung abgerufenen Daten in Remote-Tabellen gespeichert. Remotetabellen Werden nur im Arbeitsspeicher zwischengespeichert, nie in gespeichert ServiceNowDatenbanktabellen. Sie können dieses Szenario auch implementieren, indem Sie die Remote-Daten in die entsprechende schreiben ServiceNowDatenbanktabellen. Die S Das Szenario veranschaulicht, wie Daten in gespeichert werden ServiceNowDatenbanktabellen mit GlideRecord API.

Der Service Desk-Mitarbeiter gibt die erforderlichen Informationen in das FSO-Formular ein. Formulieren Sie anhand dieser Informationen den REST-Aufruf /api/getTransactions Mit RESTMessageV2 API und senden Sie sie an die Remote-Bank-Anwendung, um die Details der Finanztransaktion des Kunden zu erhalten. Die Remote-Bankanwendung verarbeitet die Anforderung und gibt die Details der Finanztransaktion des angegebenen Kunden zurück. Die Finanztransaktionsdetails werden in zwischengespeichert ServiceNowInstanz in Remotetabellen mit v_table API. Die Transaktionsdetails werden dann im FSO-Formular angezeigt.

Beispielcode

Das folgende Codebeispiel zeigt, wie verwendet wird RESTMessageV2 API zum Erstellen und Ausführen des REST-Aufrufs für die externe Bankanwendung. Speichert dann die Rückgabeergebnisse in einem Remotetabelle Mit v_table API. Bevor Sie verwenden können v_table API Sie müssen das Plugin „Remotetabellen“ (com.Glide.script.vtable) aktivieren.

(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);

Beispielcode

Das folgende Codebeispiel zeigt, wie eine Remotetabelle abgefragt und im FSO-Formular angezeigt wird.

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();