Salesforce Uzantısı

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Sürüm: 1.0.3

Salesforce hesabınızdaki verilere erişme. Veri ekleme, güncelleme, alma ve sorgulama.

Bu içerik, bu uzantıyı yapılandırmak ve kullanmak için referans sağlar.

Ön koşullar

Bu içerik, bu uzantıyı yapılandırmak ve kullanmak için referans sağlar. ExtensionExtension politikasını kullanarak bir API proxy'sinden uzantıyı kullanmadan önce:

1. RSA x509 özel anahtar/sertifika çifti oluşturun.

   Uzantıyı yapılandırırken kimlik bilgileri olarak özel anahtarı (.key) kullanacaksınız. Sertifika (.crt) dosyasını, uzantının Salesforce'a erişmesine izin verecek bağlı bir uygulama oluştururken kullanırsınız.

   openssl req -x509 -sha256 -nodes -days 36500 -newkey rsa:2048 -keyout salesforce.key -out salesforce.crt
   
   

2. Bağlı bir uygulama kurun.

   Salesforce'a bağlı bir uygulama, Salesforce uzantısına erişim sağlar. Uygulamayı kurmak için aşağıdaki talimatlara bakın.

3. Bağlı uygulamanın tüketici anahtarını alın. Uzantı, uygulamayla kimlik doğrularken bunu kullanır.

   1. Salesforce kurulumunda, sol gezinme menüsünde Uygulamalar > Uygulama Yöneticisi'ne gidin.
   2. Oluşturduğunuz bağlı uygulamayı listede bulun.
   3. Uygulamanın satırında sağ tarafta bulunan açılır listeden Görünüm'ü tıklayın.
   4. API (Enable OAuth Settings) (API (OAuth Ayarlarını Etkinleştir) bölümünde, Tüketici Anahtarı'nı bulun ve değerini uzantıyı yapılandırırken kullanılacak güvenli bir yere kopyalayın.

Bağlı bir uygulamayı uzantı ile erişim için ayarlama

Salesforce uzantısının Salesforce'a erişebilmesi için öncelikle uzantının Salesforce'a bağlanabileceği, Salesforce'a bağlı bir uygulama oluşturmanız gerekir.

Salesforce'ta bağlı bir uygulama, harici uygulamaların API'ler aracılığıyla Salesforce'a bağlanması için bir yol sağlar.

Bağlı bir uygulamayı kurmak için

1. Salesforce'a giriş yapın.
2. Sağ üstteki dişli simgesini ve ardından Kurulum'u tıklayın.
3. Soldaki gezinme menüsünde Uygulamalar > Uygulama Yöneticisi'ni genişletin.
4. Uygulama Yöneticisi sayfasında Yeni Bağlı Uygulama'yı tıklayın.
5. Temel Bilgiler'in altındaki zorunlu alanları doldurun. Değerler, muhasebe işlemleri içindir; uzantı tarafından kullanılmaz.
6. API (OAuth Ayarlarını Etkinleştir) altında, OAuth Ayarlarını Etkinleştir onay kutusunu işaretleyin.
7. Uzantı tarafından kullanılmasa da bir Geri Arama URL'si girin. http://localhost/ veya başka bir yer tutucu ana makine kullanabilirsiniz.
8. Dijital imzaları kullan onay kutusunu seçin.
9. Dijital imzalar kullan'ın altında, daha önce oluşturduğunuz salesforce.crt dosyasını bulup yüklemek için Dosya Seç'i tıklayın.
10. Seçili OAuth Kapsamları bölümünde, Seçili OAuth Kapsamları altında olmaları için aşağıdakileri ekleyin:
    • Verilerinize erişme ve bunları yönetme (api)
    • İstediğiniz zaman sizin adınıza istek gönderme (refresh_token, offline_access)
11. Kaydet'i tıklayın. Herhangi bir hata varsa salesforce.crt dosyasını yeniden oluşturup yüklemeniz gerekebilir.
12. Açılan uygulama sayfasında Yönet'i tıklayın.
13. Yeni oluşturduğunuz uygulamanın App Manager sayfasında Politikaları Düzenle'yi tıklayın.
14. OAuth politikaları bölümünde, İzin Verilen Kullanıcılar açılır listesini ve ardından Yönetici onaylı kullanıcılar önceden yetkilendirilmiştir'ı tıklayın.
15. Kaydet'i tıklayın.
16. Uygulama sayfasına dönün ve Profiller'in altında Profilleri Yönet'i tıklayın.

17. Application Profile Assignment (Uygulama Profili Ataması) sayfasında bu uygulamayı kullanabilecek kullanıcı profillerinin onay kutularını seçin.

    Uzantıyı yapılandırırken kullanıcı adını kullanacağınız kullanıcıya karşılık gelen bir profil seçtiğinizden emin olun. Ayrıca, en az Sistem Yöneticisi kullanıcılarının bu uygulamaya erişebildiğinden emin olun.

    Kullanıcının profil ayarını Salesforce'ta görüntüleyebilirsiniz. Kurulum alanında Kullanıcılar > Kullanıcılar'ı genişletin, uzantının temsil edeceği kullanıcıyı ve ardından Profil sütununda kullanıcının profilini bulun.

18. Kaydet'i tıklayın.

Salesforce hakkında

Salesforce, bir müşteri ilişkileri yönetimi (CRM) platformudur. Müşteri İlişkileri Yönetimi, şirketlerin müşteri bilgilerini ve etkileşimlerini daha iyi yöneterek müşterilerin ihtiyaçlarını anlamalarına ve sorunları çözmelerine yardımcı olur. Üstelik tüm bunları tek bir platformda, dilediğiniz masaüstünden veya cihazdan erişilebilir.

İşlemler

insert

Kayıtları sObject türleri olarak ekleyin.

<Action>insert</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "records":[ records-to-insert ],
  "allOrNone": true | false
}]]></Input>

<Action>insert</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "records":[
    { "Name": "MyAccountName" }
  ],
  "allOrNone": true
}]]></Input>

İstek parametreleri

Yanıt

Ekleme işleminden sonuçları içeren bir results dizisi.

{
  results: [
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

update

Salesforce kayıtlarını güncelleyin.

<Action>update</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "records": [ records-to-update ],
  "allOrNone": true | false
}]]></Input>

<Action>update</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "records":[
    { 
      "id":"0011U00000LQ76KQAT",
      "Name": "MyNewAccountName" 
    }
  ],
  "allOrNone": true
}]]></Input>

İstek parametreleri

Yanıt

Güncellemeden elde edilen sonuçları içeren bir results dizisi.

{
  results: [
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

al

Kayıtları kimliklerine göre sObjects olarak alın. sObject türündeki tüm alanları döndürür.

<Action>retrieve</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "ids":[ IDs-of-records-to-retrieve ]
}]]></Input>

<Action>retrieve</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "ids":["0011U00000LQ76KQAT"]
}]]></Input>

İstek parametreleri

Yanıt

JSON olarak gösterilen records sObjects dizisi. Özellik değeri null olsa bile nesnelerin tüm özelliklerinin JSON'a eklendiğini unutmayın.

{
  records: [
    { sobject-json },
    { sobject-json }
  ]
}

querySOQL

Salesforce Nesne Sorgu Dili (SOQL) kullanarak Salesforce.com'u sorgulayın.

<Action>querySOQL</Action>
<Input><![CDATA[{
  "soql": soql-query-statement
}]]></Input>

<Action>querySOQL</Action>
<Input><![CDATA[{
  "soql": "SELECT Id, Name FROM Account"
}]]></Input>

İstek parametreleri

Yanıt

Sorgunun sonuçları.

{
  totalSize: 2,
  records: [
    {
      attributes: { attributes-of-record },
      Id: '0011U00000LQ76KQAT',
      Name: 'AccountName1'
    },
    {
      attributes: { attributes-of-record },
      Id: '0011U00000LQ76LQAT',
      Name: 'AccountName2'
    }
  ],
  done: true
}

list

Salesforce.com kayıtlarını listeleyin. Belirtilen sObject türündeki tüm alanları döndürür.

<Action>list</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "limit": max-number-of-records,
  "offset": record-index-at-which-to-begin-response-set
}]]></Input>

<Action>list</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "limit": 1000,
  "offset": 0
}]]></Input>

İstek parametreleri

Yanıt

Listelenen sObject'leri JSON olarak içeren bir records dizisi.

{
  records: [
    { sobject-json },
    { sobject-json }
  ]
}

sil

Belirtilen kimliklere sahip kayıtları silin.

<Action>del</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "ids":[ IDs-of-records-to-retrieve ]
}]]></Input>

<Action>del</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "ids":["0011U00000LQ76KQAT"]
}]]></Input>

İstek parametreleri

Yanıt

İşlemin sonuçlarını içeren bir results dizisi.

{
  results:[
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

getAccessToken

Salesforce.com API erişim jetonu alın. REST API'lerini sorgulamak için kullanılabilir.

<Action>getAccessToken</Action>
<Input><![CDATA[{}]]></Input>

İstek parametreleri

Yok.

Yanıt

JSON'daki erişim jetonu.

{
  "accessToken":"00D1U0000014m3hqswvoM22I5GTw9EJrztlZ8eSSka88Q",
  "scope":"api",
  "instanceUrl": "https://na85.salesforce.com",
  "id": "https://login.salesforce.com/id/00D1U0004564mutUAA/0051U43214qecVQAQ",
  "tokenType": "Bearer"
}

Yapılandırma Referansı

Bu uzantıyı API proxy'lerinde kullanmak üzere yapılandırırken ve dağıtırken aşağıdakileri kullanın.

Sık kullanılan uzantı özellikleri

Aşağıdaki özellikler her uzantı için mevcuttur.

Bu uzantı paketinin özellikleri

Bu uzantıya özgü aşağıdaki yapılandırma özellikleri için değerler belirtin.