Salesforce Uzantısı

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

Sürüm: 1.0.5

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

Bu içerikte, bu uzantıyı yapılandırma ve kullanmayla ilgili referanslar sağlanmaktadır.

Ön koşullar

Bu içerikte, bu uzantıyı yapılandırma ve kullanmayla ilgili referanslar sağlanmaktadır. ExtensionCallout politikasını kullanarak uzantıyı bir API proxy'sinden kullanmadan önce şunları yapmanız gerekir:

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

   Uzantıyı yapılandırırken kimlik bilgileri olarak özel anahtarı (.key) kullanırsınız. Uzantıya Salesforce'a erişim izni verecek bağlı bir uygulama oluştururken sertifika (.crt) dosyasını 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 oluşturun.

   Salesforce'a bağlı bir uygulama, Salesforce uzantısına erişim sağlar. Uygulamayı ayarlamayla ilgili talimatları aşağıda bulabilirsiniz.

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

   1. Salesforce kurulumunda, sol gezinme bölmesinde Uygulamalar > Uygulama Yöneticisi'ne gidin.
   2. Listede, oluşturduğunuz bağlı uygulamayı bulun.
   3. Uygulamanın satırının sağındaki açılır menüden Göster'i tıklayın.
   4. API (OAuth Ayarlarını Etkinleştir) bölümünde Consumer Key'i bulun ve uzantıyı yapılandırırken kullanabileceğiniz güvenli bir yere kopyalayın.

Uzantının erişmesi için bağlı bir uygulama oluşturma

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

Salesforce'ta bağlı uygulamalar, harici uygulamaların API'ler aracılığıyla Salesforce'a bağlanmasına olanak tanır.

Bağlı uygulama oluşturmak için

1. Salesforce'a giriş yapın.
2. Sağ üstteki dişli simgesini, 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 bölümünde zorunlu alanları doldurun. Bu değerler muhasebe içindir ve uzantı tarafından kullanılmaz.
6. API (OAuth Ayarlarını Etkinleştir) bölümünde OAuth Ayarlarını Etkinleştir onay kutusunu işaretleyin.
7. Uzantı tarafından kullanılmasa da bir geri çağırma URL'si girin. http://localhost/ veya başka bir yer tutucu barındırma hizmetini kullanabilirsiniz.
8. Dijital imzaları kullan onay kutusunu işaretleyin.
9. Dijital imzaları kullan bölümünde Dosya seç'i tıklayarak daha önce oluşturduğunuz salesforce.crt dosyasını bulup yükleyin.
10. Seçilen OAuth Kapsamları bölümünde, aşağıdakileri Seçilen OAuth Kapsamları altında olacak şekilde ekleyin:
    • Verilerinize erişme ve bu verileri yönetme (api)
    • İstediğiniz zaman sizin adınıza istek gönderebilir (refresh_token, offline_access)
11. Kaydet'i tıklayın. Hata varsa salesforce.crt dosyasını yeniden oluşturmanız ve yüklemeniz gerekebilir.
12. Açılan uygulama sayfasında Yönet'i tıklayın.
13. Yeni oluşturduğunuz uygulamanın Uygulama Yöneticisi sayfasında Politikaları Düzenle'yi tıklayın.
14. OAuth politikaları bölümünde İzin verilen kullanıcılar açılır menüsünü, ardından Yönetici onaylı kullanıcılar önceden yetkilendirilir'i tıklayın.
15. Kaydet'i tıklayın.
16. Uygulama sayfasına dönüp Profiller bölümünde Profilleri Yönet'i tıklayın.

17. Uygulama Profili Atama sayfasında, bu uygulamayı kullanabilen kullanıcı profillerinin onay kutularını işaretleyin.

    Uzantıyı yapılandırırken kullanacağınız kullanıcı adına sahip kullanıcıya karşılık gelen bir profil seçtiğinizden emin olun. Ayrıca, en azından 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ı bulun 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üşterilerinin ihtiyaçlarını anlamalarına ve sorunları çözmelerine yardımcı olur. Tüm bunları her zaman herhangi bir masaüstü bilgisayardan veya cihazdan erişilebilen tek bir platformda yapar.

İş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

Ekle işleminin sonuçlarını 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üncelleme sonuçlarını içeren bir results dizisi.

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

al

Kayıtları kimliklerine göre sObject olarak alın. sObject türünün tüm alanlarını 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 temsil edilen bir records sObject dizisi. Mülk değeri null olsa bile nesnelerin tüm özelliklerinin JSON'a dahil edildiğini unutmayın.

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

querySOQL

Salesforce Nesne Sorgu Dili'ni (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ünün tüm alanlarını 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 sObjects'i 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 jetonunu alın. REST API'leri sorgulamak için kullanılabilir.

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

İstek parametreleri

Yok.

Yanıt

JSON biçimindeki 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 kullanılmak üzere yapılandırırken ve dağıtırken aşağıdakileri kullanın.

Ortak uzantı özellikleri

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

Bu uzantı paketine ait özellikler

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