Benutzerdefinierte Aktion „Alle Verkaufschancen abrufen“

Mit der Aktion Alle Verkaufschancen abrufen werden Verkaufschancen-Datensätze aus der Salesforce-Anwendung abgerufen. Diese Aktion wird aufgerufen, wenn Sie die Remote-Tabelle der Verkaufschance anzeigen.

Aktionseingaben

Die Aktion Alle Verkaufschancen abrufen nimmt einen einzelnen ganzzahligen Parameter an, der die maximale Anzahl von Datensätzen angibt, die von der Abfrage zurückgegeben werden sollen. Die REST-basierten Aktionen können keine Paginierung unterstützen. Aus diesem Grund ist es wichtig, die Anzahl der von der Drittanbieteranwendung zurückgegebenen Datensätze zu begrenzen. Es wird nicht empfohlen, mehr als 1.000 Datensätze in der Remotetabelle zu platzieren. Die Standardanzahl der Datensätze ist 500.

Vorverarbeitungsschritt

Der Vorverarbeitungsskript-Schritt übernimmt die Aktionseingabe als eigene.

Das Vorverarbeitungs-Skript erstellt eine SELECT-Abfrage für alle Verkaufschancen, die durch die maximale Anzahl zulässiger Datensätze begrenzt ist. Diese Abfrage basiert auf der Salesforce Object Query Language (SOQL).

(function execute(inputs, outputs) {
  
  outputs.query = "query/?q=SELECT+Name,Id,AccountId,CloseDate,Amount,” +
                  “StageName,Probability,Type+FROM+Opportunity”;

  outputs.query = outputs.query +
                  “+LIMIT+” + inputs.max_number_of_opportunity_records; 
  
})(inputs, outputs);

Sie müssen die Felder aus den Verkaufschancendatensätzen angeben, an denen Sie interessiert sind. In diesem Beispiel werden die folgenden Felder verwendet: Name, ID, Account-ID, Abschlussdatum, Menge, Phasenname und Wahrscheinlichkeit. Um die vollständige Liste der verfügbaren Felder anzuzeigen, verwenden Sie die Aktion Opportunity-Felder abrufen.

Sie können auch die Reihenfolge der Abfragesuche steuern, indem Sie das Stichwort ORDERED BY und den Wert ASC oder DESC für die Reihenfolge hinzufügen. Sie können beispielsweise dem Skript die folgende Zeile vor der Zeile hinzufügen, die den Grenzwert angibt. Dadurch gibt die Abfrage die ersten 500 Datensätze mit dem neuesten Abschlussdatum zurück.

outputs.query = outputs.query + “+ORDERED+BY+CloseDate+DESC”;

Die Ausgabe der Vorverarbeitung ist eine Abfrage.

REST-Schritt

Der REST-Schritt ist ein Standard-REST-Schritt aus den REST-basierten Aktionen der Salesforce-Spoke. Sie müssen keine Änderungen vornehmen. Stellen Sie sicher, dass sie auf den richtigen Verbindungsalias verweist.

Nachverarbeitungsschritt

Der Nachverarbeitungsskript-Schritt übernimmt die Aktionseingabe und die REST-Schrittausgabe als eigene Eingabe.

Das Nachverarbeitungsskript überprüft die Abfrageantwort auf Fehler, legt die Fehlermeldung bei Bedarf fest, extrahiert Verkaufschancendaten aus dem Antworttext und erstellt eine Informationsmeldung, die angibt, dass aufgrund der Datensatzbeschränkung nicht alle Daten aus Salesforce abgerufen wurden.

(function execute(inputs, outputs) {

  try{
    var response = JSON.parse(inputs.res_body);
  } catch(e) {
    outputs = errorHandler(inputs, outputs);
  }


  function createOutputJson(inputs, outputs) {
    try{
      outputs.records = { data: response.records };
      outputs.status = "Success";

      if ( outputs.records.data.length ==   
           inputs.max_number_of_opportunity_records ) {
        outputs.info_message = "Opportunity retrieve operation was “ +
                               “limited to" +
                               inputs.max_number_of_opportunity_records +
                               " records.";
      }      
    } catch(e) {
      outputs = errorHandler(inputs, outputs);
    }
    return outputs;
  }


  function errorHandler(inputs, outputs) {
    outputs.status = "Error";
    outputs.error_message = "Unknown Error. “ + 
                            “Please check error log for more information";

    if(inputs.res_body.contains("message"))
      outputs.error_message = response[0].message;

    return outputs;
  }

  if(inputs.status_code == "200")
    outputs = createOutputJson(inputs, outputs);
  else
    outputs = errorHandler(inputs, outputs);

})(inputs, outputs);

Im Folgenden sehen Sie Ausgaben des Nachverarbeitungsschritts.

Aktionsausgaben

Aktionsausgaben bestehen aus dem Abfragestatus, Fehler- und Informationsmeldungen und Verkaufschancen-Datensätzen. Die Aktionsausgaben finden Sie im vorherigen Screenshot.