Ana içeriğe geç

Salesforce Bulk API Receiver Connector

Salesforce Bulk API'nin etkin bir şekilde kullanılmasını ve büyük veri yüklemeleri veya güncellemeleri için daha güvenli ve performanslı bir entegrasyon sağlanmasını mümkün kılar.

Required Connector Properties​

  • Username/Password Credential: Salesforce oturum açma işlemleri için tanımlanan Basic kimlik bilgilerini ifade eder. Daha önce tanımlanmış bir kimlik bilgisinin adı sağlanır.

  • Client Id/ Client Secret Credential: Salesforce oturum açma işlemleri için tanımlanan OAuth2 kimlik bilgilerini ifade eder. Daha önce tanımlanmış bir kimlik bilgisinin adı sağlanır.

  • Bulk Api v2 Version: Salesforce Bulk API için sürümü ifade eder.

  • Process Type: İki seçeneği vardır: Bulk Query ve Bulk Data.

    • Bulk Query: Büyük veri kümelerini sorgulamak ve bu sorguların sonuçlarını almak için kullanılan bir özelliktir. Bulk query, bir Salesforce nesnesine karşı büyük veri kümelerini sorgulamak için kullanılır ve sonuçları daha verimli bir şekilde işlemek için Salesforce Bulk API ile birlikte gelir. Yanıt CSV formatında döndürülür.
    • Bulk Data: Genellikle Salesforce platformunda büyük veri yüklemeleri ve güncellemeleri gerçekleştirmek için kullanılan bir kavramı ifade eder. Salesforce Bulk API'nin bir parçası olarak, büyük veri kümelerini CSV formatında toplu olarak yüklemek veya güncellemek için kullanılır.

Required properties if Bulk Data is selected:​

  • Bulk Operation: İki seçeneği vardır: Create Job ve Upload Job Data. Create Job seçeneğinde, ne tür bir işlemin gerçekleştirileceğini (örneğin, Create, Update, Delete) ve bir işlemin hangi Salesforce nesnesi üzerinde gerçekleştirileceğini belirten parametreler içeren bir iş (job) oluşturulur. Create Job adımının sonucunda bir iş kimliği (job ID) alınır ve bu kimlik, sonraki adımlarda süreci takip etmek ve sonuçları almak için kullanılır. Upload Job Data adımında, bir iş oluşturulur ve yüklenecek verinin formatına (CSV) uygun olarak düzenlenen dosya, belirtilen iş kimliği ile ilişkilendirilerek Salesforce platformuna gönderilir. "Upload Job Data" adımı, üzerinde işlem yapılacak veriyi belirtilen işle ilişkilendirir ve bu veriyi yüklemeye hazır hale getirir.

  • Object Name: Bu parametre, eylemin hangi Salesforce nesnesine yönlendirileceğini belirtir. Örneğin, Account, Contact, Opportunity.

  • Operation: İşlem türünü belirler. Örneğin, Create, Update, Delete.

  • Column Delimiter: Sütunları ayırmak için kullanılır. Genellikle virgül (,) kullanılır.

  • Line Ending: Satır sonlarını tanımlamak için kullanılır.

  • External ID: Operation olarak Upsert seçilirse bir external ID gereklidir. Bu parametre, harici kimlik alanının adını belirtir.

Required properties if Bulk Query is selected:​

  • Column Delimiter: Sütunları ayırmak için kullanılır. Genellikle virgül (,) kullanılır.

  • Line Ending: Satır sonlarını tanımlamak için kullanılır.

  • SELECT: Veritabanından alınacak alanları belirlemek için kullanılır.

  • FROM: Verinin hangi nesneden alınacağını belirlemek için kullanılır.

  • WHERE: Sorgu sonuçlarını filtrelemek için kullanılır.

  • ORDER BY: Sorgu sonuçlarını belirli bir sırayla almak için kullanılır.

  • Order Type: Sıralama işleminde kullanılan düzeni belirtir. "ASC" ifadesi sıralamanın küçükten büyüğe (veya alfabetik sırada A'dan Z'ye) olduğunu belirtir. "DESC" ifadesi ise sıralama işleminin büyükten küçüğe (veya Z'den A'ya) yapılması gerektiğini belirtir.

  • Place Null Records: Null değerlerin sırasını belirlemek için kullanılır. "NULLS FIRST" ifadesi, sıralama işleminde null değerli kayıtları en başa koyar; "NULLS LAST" ifadesi ise null değerli kayıtları daha sonraya koyar.

  • LIMIT: Sorgu sonuçlarından kaç kayıt alınacağını belirlemek için kullanılır.