{"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":"application-rails-dintegration-de-lapi-salesforce","status":"publish","type":"post","link":"https:\/\/www.railscarma.com\/fr\/blog\/articles-techniques\/application-rails-dintegration-de-lapi-salesforce\/","title":{"rendered":"Int\u00e9gration de l'API Salesforce avec l'application 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 est connue pour \u00eatre une plate-forme de gestion de la relation client (CRM) et fournit des applications bas\u00e9es sur le cloud pour les ventes, les services et le marketing. Cet article vise \u00e0 d\u00e9velopper une compr\u00e9hension plus claire de l'API Salesforce et de la fa\u00e7on dont vous pouvez synchroniser les donn\u00e9es entre Salesforce et votre application Rails. Les \u00e9tapes suivantes doivent \u00eatre suivies pour int\u00e9grer l'API Salesforce \u00e0 votre application Rails\u00a0:\n
Utilisez la gemme Rails \u00ab restforce \u00bb \u2013 https:\/\/github.com\/ejholmes\/restforce<\/blockquote>\n

Installation<\/h4>\n
Ajoutez gem 'restforce', '~> 2.5.3' dans votre Gemfile Ex\u00e9cutez 'bundle install' ou 'gem install restforce'<\/blockquote>\n

Configuration<\/h4>\nDans votre application.yml, d\u00e9finissez les variables d'environnement suivantes\u00a0:\n
SALESFORCE_USERNAME : \u00ab nom d'utilisateur \u00bb SALESFORCE_PASSWORD : \u00ab mot de passe \u00bb SALESFORCE_SECURITY_TOKEN : \u00ab jeton de s\u00e9curit\u00e9 \u00bb SALESFORCE_CLIENT_ID : \u00ab identifiant client \u00bb SALESFORCE_CLIENT_SECRET : \u00ab secret client \u00bb SALESFORCE_HOST : \u00ab nom de domaine h\u00f4te \u00bb SALESFORCE_API_VERSION= \u00bb38.0\u2033<\/blockquote>\nEssayez de vous connecter \u00e0 Salesforce, ex\u00e9cutez \u00ab sf = Restforce.new \u00bb\n

Requ\u00eate vers Salesforce<\/h4>\nSalesforce peut avoir plusieurs objets tels que Compte, Certification_c, Apprenant, etc. Pour acc\u00e9der \u00e0 ces objets, vous pouvez appliquer les requ\u00eates suivantes.\n
    \n \t
  • requ\u00eate<\/li>\n \t
  • requ\u00eate_all<\/li>\n \t
  • s\u00e9lectionner<\/li>\n \t
  • recherche<\/li>\n \t
  • cr\u00e9er<\/li>\n \t
  • trouver<\/li>\n \t
  • mise \u00e0 jour<\/li>\n \t
  • d\u00e9truire<\/li>\n<\/ul>\n
    1. requ\u00eate<\/h5>\nExemple 1:\n
    comptes = sf.query("s\u00e9lectionnez l'identifiant, quelque chose__c du compte")<\/blockquote>\nExemple 2\u00a0: requ\u00eate bas\u00e9e sur le temps utilisant la clause WHERE #, heure de la derni\u00e8re synchronisation\n
    last_synced_at = (Time.now.utc \u2013 1.hour).strftime(\u00ab %Y-%m-%dT%H:%M:%SZ \u00bb)<\/blockquote>\n#heure syst\u00e8me actuelle\n
    current_time = Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ")<\/blockquote>\n
    sf.query("s\u00e9lectionnez Id, Something__c du compte WHERE LastModifiedDate >= #{last_synced_at} AND LastModifiedDate <= #{current_time}")<\/blockquote>\n
    2. requ\u00eate_all<\/h5>\nquery_all vous permet d'inclure les r\u00e9sultats de votre requ\u00eate que Salesforce cache dans la m\u00e9thode \u00ab requ\u00eate \u00bb par d\u00e9faut. Ceux-ci incluent \u00e9galement les enregistrements supprim\u00e9s de mani\u00e8re logicielle et les enregistrements archiv\u00e9s (par exemple, les enregistrements de t\u00e2ches et d'\u00e9v\u00e9nements, g\u00e9n\u00e9ralement archiv\u00e9s automatiquement apr\u00e8s un an).\n
    comptes = sf.query_all (\u00ab s\u00e9lectionnez l'identifiant, quelque chose__c du compte o\u00f9 isDeleted = true \u00bb)<\/blockquote>\n
    3. s\u00e9lectionnez<\/h5>\nselect permet de r\u00e9cup\u00e9rer une liste sp\u00e9cifique de champs \u00e0 partir d'un seul objet. Cela n\u00e9cessite une recherche external_id, mais est souvent beaucoup plus rapide qu'une requ\u00eate arbitraire.\n
    sf.select('Compte', '001D000000INjVe', [\u00abId\u00bb], 'Some_External_Id_Field__c')<\/blockquote>\n
    4. Rechercher<\/h5>\n# Trouver toutes les occurrences de \u00ab\u00a0bar\u00a0\u00bb\n
    sf.search('TROUVER {bar}')<\/blockquote>\n
    5. cr\u00e9er<\/h5>\n# Ajouter une nouvelle Certification_c\n
    sf.create('Certification_c', Certification_type_c\u00a0: 'RSE en personne')<\/blockquote>\n
    6. trouver<\/h5>\n# Trouver une certification par identifiant\n
    sf.find('Certification_c', '001D000000INjVe')<\/blockquote>\n
    7. mise \u00e0 jour<\/h5>\n# Mettre \u00e0 jour la 'Certification_c' avec `Id` '0016000000MRatd'\n
    sf.update('Certification_c', Id : '0016000000MRatd', Certification_type_c : 'CSR Vertual')<\/blockquote>\n
    8. d\u00e9truire<\/h5>\n# D\u00e9truire une certification par identifiant\n
    sf.destroy('Certification_c', '001D000000INjVe')<\/blockquote>\n

    Limites de l'API<\/h4>\nSalesforce a une limite d\u2019appels API par jour\/heure. Ainsi, vous pouvez simplement v\u00e9rifier le total de vos appels API et les appels disponibles.\n
    limites = sf.limits limites[\u00abDailyApiRequests\u00bb]<\/blockquote>\n
    Sortie = {"Max"=>15000, "Remaining"=>14746}<\/blockquote>\nSauvetage des erreurs de connexion \u00e0 l'API Restforce\n
    def self.connect_to_salesforce sf = nil start sf = Restforce.new Rescue Exception => e error_message = "\u00c9chec de la connexion \u00e0 Salesforce \u00e0 l'aide de Restforce Gem\u00a0!" fin fin<\/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
    Abonnez-vous pour les derni\u00e8res mises \u00e0 jour<\/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