Salesforce Uzantısı

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Sürüm: 1.0.2

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

Bu içerik, bu uzantının yapılandırılması ve kullanılması için referans sağlamaktadır.

Ön koşullar

Bu içerik, bu uzantının yapılandırılması ve kullanılması için referans sağlamaktadır. ExtensionDescription politikası aracılığıyla bir API proxy'sinden uzantıyı kullanmadan önce şunları yapmanız gerekir:

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

   Uzantıyı yapılandırırken kimlik bilgisi olarak özel anahtarı (.key) kullanacaksınız. Uzantının Salesforce'a erişmesine izin 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 uygulamayı 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ğ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 bulunduğu satırda sağdaki açılır listeden Görünüm'ü tıklayın.
   4. API (OAuth Ayarlarını Etkinleştir) bölümünde Tüketici Anahtarı'nı bulun ve değerini, uzantıyı yapılandırırken kullanmak üzere güvenli bir yere kopyalayın.

Bağlı bir uygulamayı, uzantının erişimi için ayarlama

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

Salesforce'ta bağlı 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'ta oturum açın.
2. Sağ üstteki dişli simgesini ve ardından Kurulum'u tıklayın.
3. Soldaki gezinme bölmesinde Uygulamalar > Uygulama Yöneticisi'ne gidin.
4. App Manager sayfasında Yeni Bağlı Uygulama'yı tıklayın.
5. Temel Bilgiler bölümünün altındaki zorunlu alanları doldurun. Değerler muhasebe işlemleri için kullanılır; uzantı tarafından kullanılmazlar.
6. API (OAuth Settings (OAuth Ayarlarını Etkinleştir)) bölümünde, Enable OAuth Settings (OAuth Ayarlarını Etkinleştir) onay kutusunu seçin.
7. Uzantı tarafından kullanılmasa da bir Callback URL (Geri Arama URL'si) girin. http://localhost/ veya başka bir yer tutucu ana makine kullanabilirsiniz.
8. Dijital imza kullan onay kutusunu işaretleyin.
9. Daha önce oluşturduğunuz salesforce.crt dosyasını bulup yüklemek için Dijital imzaları kullan seçeneğinin altında Dosya Seç'i tıklayın.
10. Seçili OAuth Kapsamları bölümünde, aşağıdakileri ekleyerek Seçili OAuth Kapsamları'nın altına şunları ekleyin:
    • Verilerinize erişme ve verileri yönetme (api)
    • İstediğiniz zaman istek gönderebilirsiniz (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ş'i 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ı kullanabilen 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ından Sistem Yöneticisi kullanıcılarının bu uygulamaya erişebildiğinden emin olun.

    Salesforce'ta kullanıcının profil ayarını görüntüleyebilirsiniz. Kurulum alanında Kullanıcılar > Kullanıcılar'a giderek uzantının temsil edeceği kullanıcıyı bulun, ardından Profil sütununda bu 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üşterilerinin müşterilerinin müşteri bilgilerini ve etkileşimlerini daha iyi yöneterek ihtiyaçlarını ve sorunlarını çözüyor. Tüm bunları, her zaman tüm masaüstü veya cihazlardan erişilebilen tek bir platform üzerinden gerçekleştiriyoruz.

İş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 gelen sonuçları içeren bir results dizisi.

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

geri al

Kayıtları, kimliklerine göre sObject 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 temsil edilen bir records sObjects dizisi. Nesnelerin tüm özelliklerinin, özellik değeri null olsa bile JSON'a dahil edileceğini unutmayın.

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

querySOQL

Salesforce Object Query Language (SOQL) (Salesforce Nesne Sorgusu Dili) 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ı listeleme. 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

JSON olarak listelenen sObject'leri 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'leri sorgulamak için kullanılabilir.

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

İstek parametreleri

Yok.

Yanıt

JSON dosyasındaki 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ıp 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 özel aşağıdaki yapılandırma özelliklerinin değerlerini belirtin.