Ruft anwenderdefinierte Aktion für alle Verkaufschancen ab

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Die Ruft Alle Jobangebote Ab Mit der Aktion werden Opportunity-Datensätze aus der Salesforce-Anwendung abgerufen. Diese Aktion wird aufgerufen, wenn Sie die Remote-Verkaufschancentabelle anzeigen.

    Aktionseingaben

    Die Ruft Alle Jobangebote Ab Die Aktion verwendet einen einzelnen ganzzahligen Parameter, der die maximale Anzahl von Datensätzen identifiziert, die von der Abfrage zurückgegeben werden sollen. Die REST-basierten Aktionen können keine Paginierung aufnehmen, und aus diesem Grund ist es wichtig, die Anzahl der von der Drittpartei-Anwendung zurückgegebenen Datensätze zu begrenzen. Es wird nicht empfohlen, mehr als 1.000 Datensätze in der Remote-Tabelle zu platzieren. Die Standardanzahl von Datensätzen ist 500.

    Eingabebildschirm für die Aktion „alle Möglichkeiten abrufen“, der die Aktionseingabe und den Standardwert anzeigt.

    Vorverarbeitungsschritt

    Der Vorverarbeitungsskriptschritt verwendet die Aktionseingabe als eigene.

    Bildschirm „Vorverarbeitungsschritt“, der die Aktionseingabe mit einer Pillenauswahl zum Generieren einer Abfrage anzeigt.

    Das Vorverarbeitungsskript erstellt eine AUSWAHLABFRAGE für alle Möglichkeiten, die durch die maximal zulässige Anzahl von Datensätzen begrenzt sind. 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 Jobangebotsdatensätzen angeben, an denen Sie interessiert sind. In diesem Beispiel werden die folgenden Felder verwendet: Name, ID, Account-ID, Abschlussdatum, Betrag, Phasenname und Wahrscheinlichkeit. Um die vollständige Liste der verfügbaren Felder anzuzeigen, verwenden Sie Ruft Jobangebotsfelder Ab Aktion.

    Sie können auch die Reihenfolge der Abfragesuche steuern, indem Sie das Stichwort „SORTIERT NACH“ und den Wert für die ASC- oder DESC-Reihenfolge hinzufügen. Sie können dem Skript beispielsweise die folgende Zeile vor der Zeile hinzufügen, die den GRENZWERT angibt. Dadurch werden die ersten 500 Datensätze mit dem letzten Abschlussdatum zurückgegeben.

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

    Die Vorverarbeitungsausgabe ist eine Abfrage.

    Ausgabevariablenabschnitt, der den Abfrageparameter als Ausgabe anzeigt.

    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.

    REST-Schrittbildschirm mit Verbindungsdetails und Anforderungsdetails zur Verifizierung.

    Nachverarbeitungsschritt

    Der Nachverarbeitungsskriptschritt verwendet die Aktionseingabe und DIE REST-Schrittausgabe als Eingaben.

    Bildschirm „Nachverarbeitungsschritt“, der die Eingaben anzeigt, einschließlich der Aktionseingabe und Eingabevariablen.

    Das Nachverarbeitungsskript überprüft die Abfrageantwort auf Fehler, legt die Fehlermeldung bei Bedarf fest, extrahiert Opportunity-Daten aus dem Antworttext und erstellt eine Informationsnachricht, die angibt, dass aufgrund der Beschränkung der Anzahl der Datensätze 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 finden Sie Ausgaben des Nachverarbeitungsschritts.

    Ausgabevariablenbildschirm im Schritt „Nachverarbeitung“, der Datensätze, ERROR_Messages, Info_Messages und Statusvariablen anzeigt.

    Aktionsausgaben

    Aktionsausgaben bestehen aus Abfragestatus, Fehler- und Informationsnachrichten sowie Verkaufschancendatensätzen. Die Aktionsausgaben finden Sie im vorherigen Screenshot.