/
Platzhalter - Mergefields

Platzhalter - Mergefields

Feb 29, 2024

Allgemein

Mit Platzhaltern oder sog. "Mergefields" werden Feldwerte aus Salesforce dynamisch zur Laufzeit in Angeboten ausgelesen. Diese Funktion steht für die folgenden Objekte zur Verfügung:

  • Opportunity

  • Account

  • Contact

  • Quote 

  • User

  • Produkt

Mit Hilfe von Mergefields bilden Sie Informationen nicht nur sehr schnell im Angebot ab, sondern stellen auch sicher, dass diese aktuell sind - vorausgesetzt Ihre Stammdaten in Salesforce werden sauber und kontinuierlich gepflegt. Im Angebot selbst setzen Sie den Platzhalter in geschweiften Klammern ein, z.B. um die Adressdaten des Empfängers zu ziehen. Sobald der Bearbeitungsmodus beendet ist, wird das Mergefield ausgelesen, und der hinterlegte Wert erscheint.

 


Einige Mergefields sind pro Objekt bereits vordefiniert; Sie finden Sie im Folgenden aufgelistet. Sie können jedoch auch Platzhalter für benutzerdefinierte Felder definieren und diese ebenso in Angeboten verwenden.

 

Anlage benutzerdefinierter Mergefields

Benutzerdefinierte Mergefields können, gegliedert nach Objekt, entweder im Admin-Bereich des Editors - Einstellungen, Reiter "Funktionalität" - oder über die entsprechenden Setup-Texte hinzugefügt werden:



Admin Einstellung

entsprechender Setup-Text

Admin Einstellung

entsprechender Setup-Text

Zusätzliche Felder für Angebot

quoteFields

Zusätzliche Felder für Opportunity

opportunityFields

Zusätzliche Felder für Account

accountFields

Zusätzliche Felder für Kontakt

contactFields

Zusätzliche Felder für Benutzer

userFields

 

Custom Mergefields erfordern den vollständigen API-Namen inkl. Namespace, wenn vorhanden. Dieser ist auch im Setup-Parameter bzw. in den Einstellungen einzutragen. Die Groß- und Kleinschreibung kann hingegen ignoriert werden.

 

Hinweis zu benutzerdefinierten Variablen mit dem Prefix sf42_quotefx__SF42_

Sofern Sie benutzerdefinierte Felder als Variablen einsetzen möchten, die als Prefix die Zeichenfolge sf42_quotefx__SF42_ aufweisen, beachten Sie bitte folgendes:

  • In den Setup-Text tragen Sie den korrekten API-Namen ein

  • In der Variable ersetzen Sie die Zeichenfolge 'sf42_quotefx__' durch 'quote__'. Die restliche Konfiguration bleibt gleich wie im folgenden beschrieben.

Beispiel: Aus dem Feld  sf42_quotefx__SF42_QuoSum_Listprice__c wird die Variable {quote__SF42_QuoSum_Listprice__c}.



Mergefields können auch in bestimmten Setup-Texten verwendet werden. An dieser Stelle werden allerdings gleich die vollständigen Platzhalter in geschweiften Klammern eingetragen:

Admin Einstellung

entsprechender Setup-Text

Beispiel 

Admin Einstellung

entsprechender Setup-Text

Beispiel 

Formatierung des Namens des Angebots in Salesforce

quotesavename

{QuoteNumber} - {AccountOpp_Name} {QuoteDate}

Formatierungs des Namens für das Angebots PDF

quoteattachementname

Angebot {QuoteName}

Formatierung der QuoteMatchID

quoteMatchID

Quo-{QuoteNumber}-{QuoteDate}

Konfiguration

Die Mergefields-Sidebar gibt Ihnen alle vorhandenen Variablen in korrekter Formatierung aus. Die folgenden Abschnitte dienen dem besseren Verständnis und zum Überblick, welche Variablen Standard und welche im Setup zusätzlich hinterlegt werden müssen. Es ist mit Version Summer '20 nicht mehr notwendig, die Variablen manuell in das Angebot zu schreiben.



Mergefields bezogen auf das Angebot

Standard Quote Mergefields

Folgende Platzhalter können direkt im Angebotseditor verwendet werden. Wichtig ist dabei die Schreibweise in geschweiften Klammern:

 

Mergefield

referenzierter Wert / Salesforce Feld

Besonderheit

Mergefield

referenzierter Wert / Salesforce Feld

Besonderheit

{QuoteSumNet}

SF42_QuoteSum_Netto__c

Wird nur im PDF ausgelesen.

{QuoteName}

Name

 

{QuoteNumber}

SF42_QuoNumber__c

 

{QuoteDate}

SF42_QuoDate__c

 

{OrderDate}

SF42_QuoDate__c

 

{ValidDate}

SF42_QuoValidThruDate__c

 

{QuoteVersion}

SF42_QuoVersion__c

 

{VAT}

SF42_Tax_Quote__c

 

{QuoteSumVat}

SF42_QuoSum_Vat__c

Wird nur im PDF ausgelesen.

{QuoteSumGross}

SF42_QuoSum_Brutto__c

Wird nur im PDF ausgelesen.

{RelatedQuoteNumber}

SF42_relatedQuote__r.SF42_QuoNumber__c

 

{RelatedQuoteName}

SF42_relatedQuote__r.Name

 

{AcceptedQuoteNumber}

s. Auftragsbestätigung

 

{AcceptedQuoteName}

s. Auftragsbestätigung

 

Custom Quote Mergefields

Für Custom Mergefields kann einfach der API-Name des gewünschten Angebots-Feldes in geschweiften Klammern verwendet werden, sofern er im zugehörigen Setup-Text quoteFields hinterlegt ist.

Mergefields bezogen auf den Account

Bei Mergefields zum Account gilt es zunächst, zwischen den verschiedenen am Angebot beteiligten Accounts zu unterscheiden (s. Abschnitt "Mehrstufiger Vertrieb")

 

 

Opportunity Account

Primärer Account 

Account 2

Account 3

Account 4

 

Opportunity Account

Primärer Account 

Account 2

Account 3

Account 4

Objekt/Feld in Salesforce

SF42_QuoAccount__c

SF42_QuoActiveAccount__c

SF42_QuoAccount2__c

SF42_QuoAccount3__c

SF42_QuoAccount4__c

Definition

Standard

Primärer Account für das jeweilige Angebot

Das Label für den Account 2 wird im Setup Parameter Account2 festgelegt, z.B. Reseller.

Das Label für den Account 3 wird im Setup Parameter Account3 festgelegt, z.B. Distributor.

Das Label für den Account 4 wird im Setup Parameter Account4 festgelegt, z.B. Enduser.

Prefix für Standard Mergefields

AccountOpp_

active.

(setup-text account2)_

(setup-text account3)_

(setup-text account4)_

 

Das Prefix der Variablen für Account 2-4 basiert auf dem Label, das in den Einstellungen im Reiter Accounts vergeben wurde. Sofern das Label für einen zusätzlichen Account ein Leerzeichen enthält z.B. "Media Agentur", wird dieses in den zugehörigen Variablen automatisch zusammengezogen, z.B. bei {MediaAgentur_Name}. Es ist nicht nötig, das Label manuell anzupassen.

Standard Account Mergefields

Die Standard Account Mergefields werden mit Unterstrich (Ausnahme 'Primärer Account: mit Punkt) an das jeweilige Account-Prefix angefügt. Folgende Mergefields stehen zur Verfügung:

 

Mergefield

referenzierter Wert / Salesforce Feld 

Beispiel Opportunity Account

Beispiel
Primärer Account 

Beispiel
Account 2

Beispiel
Account 3

Beispiel
Account 4

Mergefield

referenzierter Wert / Salesforce Feld 

Beispiel Opportunity Account

Beispiel
Primärer Account 

Beispiel
Account 2

Beispiel
Account 3

Beispiel
Account 4

_Name

Account.Name

{AccountOpp_Name}

{active.Name}{Account}

{reseller_Name}

{distributor_Name}

{enduser_Name}

_Street

Account.BillingStreet

 

{Street}

 

 

 

_Zip

Account.BillingPostalCode

 

{Zip}

 

 

 

_City

Account.BillingCity

 

{City}

 

 

 

_State

Account.BillingState

 

{State}

 

 

 

_Country

Account.BillingCountry

 

{Country}

 

 

 

_Payment

Account.SF42_Zahlungsbedingungen__c

 

{active.payment}

 

 

 

_Website

Account.Website

 

 

 

 

 

_Type

Account.Type

 

 

 

 

 

_Owner

Account.Owner.Name

 

 

 

 

 

_ShippingStreet

Account.ShippingStreet

 

 

 

 

 

_ShippingZip

Account.ShippingPostalCode

 

 

 

 

 

_ShippingCity

Account.ShippingCity

 

 

 

 

 

_ShippingCountry

Account.ShippingCountry

 

 

 

 

 

_ShippingState

Account.ShippingState

 

 

 

 

 

Custom Account Mergefields

Für Custom Account Mergefields wird zunächst der API-Name des referenzierten Feldes im zugehörigen Setup-Text accountsFields hinterlegt. Anschließend wird er mit Punkt getrennt an das jeweilige Account-Prefix angefügt:

 

Opportunity Account

Primärer Account für das jeweilige Angebot

Account 2

Account 3

Account 4

 

Opportunity Account

Primärer Account für das jeweilige Angebot

Account 2

Account 3

Account 4

Objekt /Feld in Salesforce

SF42_QuoAccount__c

SF42_QuoActiveAccount__c

SF42_QuoAccount2__c

SF42_QuoAccount3__c

SF42_QuoAccount4__c

Prefix für Custom Mergefield

AccountOpp.

active.

(setup-text account2).

(setup-text account3).

(setup-text account4).

Systematik

AccountOpp.ApiFieldname

active.ApiFieldname

setup-text account2.ApiFieldname

setup-text account3.ApiFieldname

setup-text account4.ApiFieldname

Beispiel Custom Mergefield am Beispiel des Feldes "Industry"

{AccountOpp.Industry}

{active.Industry}

{reseller.Industry}

{distributor.Industry}

{enduser.Industry}

Mergefields bezogen auf den Kontakt

Bei Mergefields zum Kontakt gilt es ebenso, zwischen den verschiedenen am Angebot beteiligten Accounts und ihren Kontakten zu unterscheiden (s. Abschnitt "Mehrstufiger Vertrieb").

 

 

Kontakt Opportunity Account

Kontakt am primären Account 

Kontakt Account 2

Kontakt Account 3

Kontakt Account 4

 

Kontakt Opportunity Account

Kontakt am primären Account 

Kontakt Account 2

Kontakt Account 3

Kontakt Account 4

Objekt/Feld in Salesforce

SF42_QuoContact__c

-

SF42_QuoContact2__c

SF42_QuoContact3__c

SF42_QuoContact4__c

Definition

Standard

Zugehöriger Kontakt des primären Accounts für das jeweilige Angebot.

Das Label wird im Setup Parameter Account2 festgelegt, z.B. Reseller.

Das Label wird im Setup Parameter Account3 festgelegt, z.B. Distributor.

Das Label wird im Setup Parameter Account4 festgelegt, z.B. Enduser.

Prefix für Standard Mergefields

AccountOpp_Contact_
Opp_Contact_

active.Contact.

(setup-text account2)_Contact_

(setup-text account3)_Contact_

(setup-text account4)_Contact_

 

Das Prefix der Variablen für Kontakt 2-4 basiert auf dem Label, das in den Einstellungen im Reiter Accounts vergeben wurde. Sofern das Label für einen zusätzlichen Account ein Leerzeichen enthält z.B. "Media Agentur", wird dieses in den zugehörigen Variablen automatisch zusammengezogen, z.B. bei {MediaAgentur_Name}. Es ist nicht nötig, das Label manuell anzupassen.

Standard Contact Mergefields

Die Standard Contact Mergefields werden mit Unterstrich (Ausnahme 'Primärer Account: mit Punkt) an das jeweilige Contact-Prefix angefügt. Folgende Platzhalter stehen zur Verfügung:

 

Mergefield

zugehöriger Feldname am Objekt

Beispiel
Kontakt Opportunity Account

Beispiel
Kontakt am primären Account

Beispiel
Kontakt Account 2

Beispiel
Kontakt Account 3

Beispiel
Kontakt Account 4

Mergefield

zugehöriger Feldname am Objekt

Beispiel
Kontakt Opportunity Account

Beispiel
Kontakt am primären Account

Beispiel
Kontakt Account 2

Beispiel
Kontakt Account 3

Beispiel
Kontakt Account 4

_Contact_Name

Name

{AccountOpp_Contact_Name}
{Opp_Contact_Name}

{active.Contact.Name}

{reseller_Contact_Name}

{distributor_Contact_Name}

{enduser_Contact_Name}

_Contact_FirstName

FirstName

 

{FirstName}

 

 

 

_Contact_LastName