{"id":26937,"date":"2017-07-26T11:25:41","date_gmt":"2017-07-26T11:25:41","guid":{"rendered":"https:\/\/dev.railscarma.com\/salesforce-api-integration-rails-app\/"},"modified":"2021-06-05T07:53:10","modified_gmt":"2021-06-05T07:53:10","slug":"app-rails-con-integrazione-api-salesforce","status":"publish","type":"post","link":"https:\/\/www.railscarma.com\/it\/blog\/articoli-tecnici\/app-rails-con-integrazione-api-salesforce\/","title":{"rendered":"Integrazione dell'API Salesforce con l'app Rails"},"content":{"rendered":"
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tSalesforce \u00e8 nota per essere una piattaforma di Customer Relationship Management (CRM) e fornisce applicazioni basate su cloud per le vendite, l\u2019assistenza e il marketing. Questo articolo ha lo scopo di fornire una comprensione pi\u00f9 chiara dell\u2019API di Salesforce e di come sia possibile sincronizzare i dati tra Salesforce e la propria applicazione Rails.\n\nPer integrare l'API di Salesforce con la propria applicazione Rails, \u00e8 necessario seguire i seguenti passaggi:\n
Utilizza la gemma Rails \u201crestforce\u201d \u2013 https:\/\/github.com\/ejholmes\/restforce<\/blockquote>\n

Installazione<\/h4>\n
Aggiungi \u2018gem \u2019restforce\u2018, \u2019~> 2.5.3\u2018\u2019 al tuo Gemfile\nEsegui \u2018bundle install\u2019 oppure \"gem install restforce\"<\/blockquote>\n

Configurazione<\/h4>\nNel file application.yml, imposta le seguenti variabili d'ambiente: \u2013\n
SALESFORCE_USERNAME: \u201cnome utente\u201d\nSALESFORCE_PASSWORD: \u201cpassword\u201d\nSALESFORCE_SECURITY_TOKEN: \u201ctoken di sicurezza\u201d\nSALESFORCE_CLIENT_ID: \u201cID cliente\u201d\nSALESFORCE_CLIENT_SECRET: \u201csegreto cliente\u201d\nSALESFORCE_HOST: \u201cnome dominio host\u201d\nSALESFORCE_API_VERSION=\u201d38.0\u2033<\/blockquote>\nProva a collegarti a Salesforce eseguendo \u201csf = Restforce.new\u201d\n

Esecuzione di query su Salesforce<\/h4>\nSalesforce pu\u00f2 contenere diversi oggetti, quali Account, Certification_c, Learner ecc. Per accedere a questi oggetti, \u00e8 possibile utilizzare le seguenti query.\n
    \n \t
  • richiesta<\/li>\n \t
  • query_all<\/li>\n \t
  • seleziona<\/li>\n \t
  • cerca<\/li>\n \t
  • creare<\/li>\n \t
  • trova<\/li>\n \t
  • aggiornamento<\/li>\n \t
  • distruggere<\/li>\n<\/ul>\n
    1. query<\/h5>\nEsempio 1:\n
    accounts = sf.query(\u201cselect Id, Something__c from Account\u201d)<\/blockquote>\nEsempio 2: Query basata sul tempo utilizzando la clausola WHERE\n# ora dell'ultima sincronizzazione\n
    last_synced_at = (Time.now.utc \u2013 1.hour).strftime(\u201c%Y-%m-%dT%H:%M:%SZ\u201d)<\/blockquote>\n#: ora di sistema corrente\n
    current_time = Time.now.utc.strftime(\u201c%Y-%m-%dT%H:%M:%SZ\u201d)<\/blockquote>\n
    sf.query(\u201cselect Id, Something__c from Account WHERE LastModifiedDate >= #{last_synced_at} AND LastModifiedDate <= #{current_time}\u201d)<\/blockquote>\n
    2. query_all<\/h5>\nquery_all consente di includere i risultati della query che Salesforce nasconde nel metodo \u201cquery\u201d predefinito. Tra questi figurano anche i record sottoposti a cancellazione temporanea e quelli archiviati (ad esempio, i record relativi a attivit\u00e0 ed eventi, che di solito vengono archiviati automaticamente dopo un anno dalla loro creazione)\n
    accounts = sf.query_all(\u201cselect Id, Something__c from Account where isDeleted = true\u201d)<\/blockquote>\n
    3. selezionare<\/h5>\nIl comando `select` consente di recuperare un elenco specifico di campi da un singolo oggetto. Richiede una ricerca tramite `external_id`, ma spesso \u00e8 molto pi\u00f9 veloce di una query arbitraria.\n
    sf.select(\u2018Account\u2019, \u2018001D000000INjVe\u2019, [\u201cId\u201d], \u2018Some_External_Id_Field__c\u2019)<\/blockquote>\n
    4. Ricerca<\/h5>\n# Trova tutte le occorrenze di \u2018bar\u2019\n
    sf.search(\u2018FIND {bar}\u2019)<\/blockquote>\n
    5. creare<\/h5>\n# Aggiungi una nuova certificazione_c\n
    sf.create(\u2018Certification_c\u2019, Certification_type_c: \u2018CSR In-Person\u2019)<\/blockquote>\n
    6. trovare<\/h5>\n# Trova una certificazione in base all'ID\n
    sf.find(\u2018Certification_c\u2019, \u2018001D000000INjVe\u2019)<\/blockquote>\n
    7. aggiornamento<\/h5>\n# Aggiornare il file \u2018Certification_c\u2019 con l\u2018`Id` \u20190016000000MRatd\u201d\n
    sf.update(\u2018Certification_c\u2019, Id: \u20180016000000MRatd\u2019, Certification_type_c: \u2018CSR Vertual\u2019)<\/blockquote>\n
    8. distruggere<\/h5>\n# Elimina una certificazione in base all'ID\n
    sf.destroy(\u2018Certification_c\u2019, \u2018001D000000INjVe\u2019)<\/blockquote>\n

    Limiti API<\/h4>\nSalesforce prevede un limite alle chiamate API per giorno e per ora. Pertanto, \u00e8 sufficiente controllare il numero totale di chiamate API effettuate e quelle ancora disponibili.\n
    limits = sf.limits\nlimits[\u201cDailyApiRequests\u201d]<\/blockquote>\n
    Output = {\u201cMax\u201d=>15000, \u201cRemaining\u201d=>14746}<\/blockquote>\nRisoluzione degli errori di connessione all'API di Restforce\n
    def self.connect_to_salesforce\n   sf = nil\n   begin\n sf = Restforce.new\n   rescue Exception => e\n error_message = \"Impossibile connettersi a Salesforce utilizzando la gemma restforce!\" \n end\n end<\/code><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
    \n\t\t\t\t\t\t
    \n\t\t\t\t\t
    \n\t\t\t
    \n\t\t\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t
    Iscriviti per gli ultimi aggiornamenti<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t\t\t
    \t\t\t\t\t