Dataconnectoren Salesforce

Owned by Paul van der Koore
Last updated: 01 Nov 2021 by Jack Kuijper
3 min read

In onderstaand voorbeeld wordt een dataconnector gemaakt die vanuit een Quote kan worden aangeroepen. Omdat een Quote in Salesforce aan een Account is gekoppeld, wordt van de Quote ook het bijbehorende Account opgehaald. Zo kun je verschillende niveaus tegelijk in één dataconnector ophalen. Aan een quote is bijvoorbeeld ook een Opportunity gekoppeld en een Contact gekoppeld. Met de bijbehorende OpportunityID en ContactID velden kun je de gegevens van deze objecten uit Salesforce ophalen.

Wil je gegevens ophalen uit meerdere objecten die niet rechtstreeks (1 niveau diep) in Salesforce aan elkaar gekoppeld zijn, heb je meerdere dataconnectoren nodig die dan via filters in DocuBuilder aan elkaar gekoppeld kunnen worden.

Stap voor stap

Aanmaken dataconnector voor diepste niveau

Om meerdere dataconnectors ‘aan elkaar te knopen’, start je met de dataconnector op het diepste niveau. In onderstaand voorbeeld gaan we uit van de Salesforce objecten Account en Quote, waarbij Quote het diepste niveau is. Dat is ons startpunt in onderstaand voorbeeld.

  1. Maak een nieuwe dataconnector door te klikken op de knop Creëren:

     

  2. Geef de dataconnector op het tabblad General een Name, kies bij Connector definition voor Salesforce connector, bij Connector type voor Usable for 1:1 en zet een vinkje bij Empty at startup:

     

  3. Ga op het tabblad Definition naar het veld Data source en geef de SOQL-code in om het Quote ID op te halen uit Salesforce. Voor het Salesforce object Quote is dit als volgt:

    SELECT Id FROM Quote

     

  4. Selecteer met je muis de tekst Id en klik vervolgens op de knop Insert field:

     

  5. In het scherm dat nu verschijnt selecteer je alle velden uit de Quote die je nodig hebt (inclusief het Id veld) van de betreffende Quote. Klik op Insert om de velden toe te voegen aan de SOQL query:

     

  6. De query bij het veld Data source ziet er nu als volgt uit:

     

  7. Klik op de knop Merge fields onderin het scherm om de Salesforce velden te koppelen aan Mergefields (= DocuBuilder velden):

     

  8. Zet een vinkje voor alle velden die je wilt koppelen en geef in de kolom Merge field duidelijke veldnamen mee. Let op, eventuele spaties in Mergefields worden automatisch vervangen door een underscore. Wij adviseren dan ook eventuele spaties in Mergefields helemaal te verwijderen en alleen hoofd- en kleine letters te gebruiken:

     

  9. Klik op OK om de dataconnector en de daaraan gekoppelde Mergefields op te slaan.

Aanmaken mergefields voor in Salesforce gekoppelde objecten

Doordat in Salesforce aan een Quote ook het bijbehorende Account is gekoppeld, zijn deze velden ook toe te voegen in de dataconnector. Je moet dan echter wel de veldnaam weten, deze velden zijn niet via de knop Insert field op te vragen. De meeste van deze veldnamen zijn terug te vinden in de object manager in Salesforce.

  1. Voeg de aan de Opportunity gekoppelde Account-velden toe via Account, een punt en de veldnaam:

     

  2. Via de knop Merge fields onderin het scherm kun je vervolgens ook deze velden koppelen aan aan Mergefields (= DocuBuilder velden):