Exemple de script d'intégration de données tierces

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 1 minute de lecture
  • Le script de table distante peut être conçu pour extraire des enregistrements d'une application tierce. Ce script est appelé lorsqu'une requête d'accès aux données de la table distante est faite.

    Pour pouvoir utiliser une table distante avec IntegrationHub, vous devez identifier le spoke IntegrationHub qui fonctionne avec l'application tierce. Le spoke se compose des actions du Flow Designer qui ont été créées pour apporter divers jeux de données secondaires de cette application.

    Par exemple, si vous avez besoin d'apporter des informations de compte de l'application Salesforce, vous devez utiliser le spoke Salesforce et l'action Obtenir tous les comptes. Un exemple du script de table distante qui accède à cette action est présenté ci-dessous.

    (function executeQuery(v_table, v_query) {
      try {
        // prepare inputs for the spoke actions 
        // Get All Accounts action does not have any inputs).
        var inputs = {};
    
        // call spoke action
        var outputs = sn_fd.FlowAPI.executeAction(
                                    "sn_salesforce_spok.get_all_accounts", inputs);
    
        // check if Action was completed successfully
        if (outputs.status != "Success") {
          throw new Error(outputs.errorMessage);
        }
    
        // extract payload from the action outputs
        var accounts = outputs.accounts.data;
    
        // map action output data to the remote table columns and Sys Id
        for (var i = 0; i < accounts.length; i++) {
          v_table.addRow({
            "u_sf_account_id": accounts[i].name,
            "u_sf_account_name": accounts[i].label,
            // assign remote table Sys Id to the primary key of the third-party
            // record
            "sys_id": accounts[i].name,
          });
        }
    
      // process errors 
      } catch (error) {
         gs.addErrorMessage("Error trying to retrieve  Salesforce Accounts." +
                            "Please contact System Administrator.");
         gs.addErrorMessage("System Error: " + error.message);
      }
    
    })(v_table, v_query);
    
    Remarque :
    toutes les actions IntegrationHub ne peuvent pas être invoquées depuis les scripts de table distante. Plus précisément, les actions de flux de données ne peuvent pas être appelées depuis les scripts. Si l'action que vous souhaitez utiliser est une action de flux de données, vous devrez peut-être créer votre propre action basée sur l'étape REST. Un moyen simple de créer une action est de copier une action existante, puis de la modifier pour atteindre votre objectif. Un exemple d'actions de spoke personnalisées est disponible dans cette rubrique : Créer des actions de spoke Salesforce pour récupérer des opportunités à utiliser dans la définition de table distante.