Versions Compared

Version Old Version 3 New Version 4
Changes made by

Phu Nguyen (Unlicensed)

Phu Nguyen (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Einführung

Mithilfe von benutzerdefinierten Spalten können Sie zusätzliche Inhalte zu Ihren Produkten strukturiert im Angebotsdokument abbilden. Diese sog. Custom Columns haben zwar keine kalkulatorische Funktion, erweitern aber das inhaltliche Spektrum Ihrer Angebotsgestaltung. Da sie separat in benutzerdefinierte Felder der Angebotsposition geschrieben werden, bleibt die Angebotsgestaltung in Ihrem Unternehmen stets transparent und lässt sich einfach über Salesforce Berichte auswerten.

Note
titleCustom Columns vs. Produkteigenschaften

Einige der Informationen, die Sie über Custom Columns abbilden, könnten Sie auch mithilfe von Produkteigenschaften ermitteln. Wo liegt also der Unterschied? Eine Produkteigenschaft ist jeweils einem Produkt oder Produkten einer Produktgruppe zugeordnet. Sie wird also nur in bestimmten Fällen abgefragt, der ermittelte Wert erscheint nicht als eigene Spalte im Angebotsdokument.

Es macht also dann Sinn, Custom Columns zu definieren, wenn die erfragten Spezifikationen auf jedes Ihrer Produkte zutreffen und auch deutlich sichtbar im Angebot abgebildet werden sollen.

Custom Columns haben keinerlei kalkulatorische Funktion, selbst wenn es sich um Währungs- oder Zahlenfelder handelt. Die hier abgebildeten Werte haben rein informativen Charakter.

Konfiguration

An der Angebotsposition

Inhalte, die Sie über benutzerdefinierte Spalten abbilden wollen, werden zunächst als benutzerdefinierte Felder am Objekt Angebotsposition

Introduction

With the help of custom columns, you can map additional content for your products in a structured way in the quote document. These so-called custom columns do not have a calculatory function, but they expand the content spectrum of your quote design. Since they are written separately in custom fields of the Quote Line Item, the quote design in your company always remains transparent and can be easily evaluated via Salesforce reports.

Note

Custom Columns vs. Product Properties

Some of the information you map via Custom Columns could also be determined using product properties. So what's the difference? A product property is assigned to a product or products in a product group. It is therefore only queried in certain cases, and the determined value does not appear as a separate column in the quotation document.

It therefore makes sense to define custom columns if the requested specifications apply to each of your products and should also be clearly displayed in the quote.

Custom Columns have no calculatory function, even if they are currency or number fields. The values shown here are purely informative.

Configuration

At the Quote Line Item

Content that you want to map using custom columns is first created as custom fields on the object "Position" sf42_quotefx__SF42_GenLineItem__c angelegt. Es stehen sechs verschieden Feldtypen zur Auswahl:

Feldtyp

. There are six different field types to choose from:

Field Type

API-Name

Beispiel

Example

Input

Beispiel

Example

Text

CustomText__c

abc

Zahl

Number

CustomNumber__c

123

Prozent

Percentage

CustomPercent__c

10%

Währung

Currency

CustomCurrency__c

10,00 €

Auswahlliste

Picklist

CustomPicklist__c

blau

blue,

weiß

white,

rot

red

Tip

Bitte legen Sie das Feld als Unrestricted Picklist an oder ergänzen Sie den Auswahlwert "Null", damit der Übertrag auf das Opportunity-Produkt funktioniert.

Sofern Sie der Picklist einen Standardwert zuweisen, wird Ihre benutzerdefinierte Spalte mit diesem vorbefüllt (sofern kein anderer Wert am Produkt hinterlegt ist

Please create the field as Unrestricted Picklist or add the selection value "Null" to make the transfer to the opportunity product work.

If you assign a default value to the picklist, your custom column will be pre-populated with this value (if no other value is stored on the product).

URL

CustomURL__c

www.appero.com

Note

Die benutzerdefinierten Felder, die Sie auf der Angebotsposition erstellen, werden mit derselben Formatierung - z.B. Anzahl Dezimalstellen, Zeichenlänge, Auswahlwerte - als Spalte im The custom fields you create on "Position" are mapped with the same formatting - e.g. number of decimal places, character length, selection values - as a column in the appero quote Lightning Editor abgebildet.

Im Angebotseditor

Nachdem Sie die gewünschten Felder auf der Angebotsposition angelegt haben, stehen Sie Ihnen als Spalten im Angebotseditor zur Verfügung und können dem Layout ganz normal hinzugefügt werden.

Image Removed

An jedem Produkt, dass sie dem Angebot hinzufügen, können Sie die Spalten nun nach Belieben befüllen:

Image Removed

Mit dem Speichern des Angebots werden die eingetragenen Werte auf die entsprechenden Felder der Angebotsposition geschrieben und können dort ebenfalls ausgelesen werden.

An der Opportunity

Note

Sofern Sie die Werte aus den Custom Columns auch auf die Opportunity-Produkte übertragen möchten, legen Sie bitte die exakt selben Felder (identische API-Namen, identischer Feldtyp) auf dem Opportunity Produkt OpportunityLineItem an. 
Mit dem Befehl "Produkte in Opportunity kopieren" werden auch die Werte der Custom Columns auf die entsprechenden Felder geschrieben.

Custom Fields aus dem Produkt abbilden

Custom Columns lassen sich auch dazu verwenden, weitere Informationen zu Ihren Produkten, die Sie dort über benutzerdefinierte Felder pflegen, im Angebot in eigenen Spalten abzubilden.

Note

Der Schlüssel hierzu ist ebenfalls, dass Sie zu jedem benutzerdefinierten Feld am Produkt ein identisches Feld (identische API-Namen, identischer Feldtyp) auf der Angebotsposition und bei Bedarf auch auf dem Opportunity Produkt anlegen.

Fügen Sie diese Felder Ihrem Angebot wie oben beschrieben als Spalte hinzu. Sofern die Felder am Produkt mit Werten belegt sind, werden diese beim Einfügen des Produkts ins Angebot automatisch in die Custom Columns geschrieben.

Custom Columns und Produkteigenschaften

Es besteht die Möglichkeit, Werte aus Produkteigenschaften in benutzerdefinierten Spalten abzubilden.

Tragen Sie dazu in das Feld Opp Lineitem API 

In the quote editor

After you have created the desired fields on "Position", they will be available as Columns in the Quote Editor and can be added to the layout normally.

Image Added

At each product that you add to the quote, you can now fill the columns as you wish:

Image Added

When saving the quote, the entered values are written to the corresponding fields of the Quote Line Item and can be read out there as well.

At the Opportunity

Note

If you want to copy the values from the Custom Columns to the Opportunity products as well, please create the exact same fields (identical API names, identical field type) on the Opportunity product OpportunityLineItem. The "Copy Products to Opportunity" command will also write the values from the Custom Columns to the corresponding fields.

Map custom fields from the product

Custom Columns can also be used to map additional information about your products, which you maintain there via custom fields, in separate columns in the quote.

Note

The key here is also to create an identical field (identical API names, identical field type) for each custom field on the product on the Quote Line Item and also on the Opportunity Product if needed.

Add these fields to your quote as a column as described above. If the fields on the product have values, these will be automatically written to the Custom Columns when the product is inserted into the quote.

Custom Columns und Product Properties

It is possible to map values from product properties to custom columns.

To do this, enter the API name of the field at the Quote Line Item that is to be used as a custom column in the Opp Lineitem API sf42_quotefx__SF42_OppLiAPIfieldname__c an der Produkteigenschaft den API-Namen desjenigen Feldes an der Angebotsposition ein, dass als Custom Column herangezogen werden soll. Wichtig ist auch hier, dass Eigenschaftstyp und Feldtyp an der Angebotsposition übereinstimmen.

Image Removed

NoteSofern Sie Ihrer Produkteigenschaft einen Default-Wert vorgeben

field at the product property. Again, it is important that the property type and the field type at the Quote Line Item match.

Image Added
Note

If you specify a default value for your product property (sf42_quotefx__SF42_PreassignedValue__c) wird dieser direkt in die Custom Column geschrieben.

Image Removed

Änderungen an der Produkteigenschaft werden dann zeitgleich in die Custom Column geschrieben. Umgekehrt beeinflussen Änderungen an der Spalte den Eigenschaftswert nicht.

Tip

Schlüssel für das Zusammenspiel von Angebotsposition, Spalte, Opportunity-Produkt, Produkt und Produkteigenschaft ist, dass stets identische API-Namen und Feldtypen (Text, Zahl, Währung, Prozent, Auswahlliste, URL) verwendet werden. Bei Abweichungen hinsichtlich Name oder Typ schlägt die Synchronisierung fehl und die Werte werden ignoriert.

Ausnahme sind Produkteigenschaften vom Typ Tabelle/Relation: Hier muß die zugehörige Custom Column unabhängig vom abgefragen Feld vom Typ Text sein.

Bilder in benutzerdefinierten Spalten abbilden

Mit Version 20.100 können Sie auch Bilddateien via URL in benutzerdefinierten Spalten abbilden.

Hierzu legen Sie am Product2 ein Formelfeld mit einer IMAGE-Funktion an - alternativ ein Textfeld mit einem vollständigen html Tag - und als Zielfeld auf der Angebotsposition ein gleichnamiges Feld vom Typ Langtext. Die API-Namen beider Felder enden auf ImageUrl__c. Wenn Sie die Spalte nun im Angebot einfügen, wird das zum Link gehörende Bild ausgelesen.

Wenn Bilder außerhalb von Salesforce verwendet werden sollen, konfigurieren Sie bitte dazu das Remote-Site-Setting.

Warning
titleCustom Columns und Mehrsprachigkeit

Bitte beachten Sie, dass benutzerdefinierte Spalten vom Typ Auswahlliste immer die Feldwerte in der User-Sprache abbilden. Das Feature "Mehrsprachigkeit" wird hier nicht unterstützt, it will be written directly to the custom column.

Image Added

Changes to the product property are then written to the custom column at the same time. Conversely, changes to the column do not affect the property value.

Tip

Key for the interaction of Quote Line Item, Column, Opportunity Product, Product and Product Property is that always identical API names and field types (Text, Number, Currency, Percent, Pick List, URL) are used. If there are any deviations in terms of name or type, the synchronization will fail and the values will be ignored.

Exception are product properties of type Table/Relation: Here the associated Custom Column must be independent of the queried field of type Text.

Map images in custom columns

With version 20.100 you can also map image files via URL in custom columns.

To do this, create a calculation field with an IMAGE function at Product2 - alternatively a text field with a full html tag - and a long text type field of the same name as the target field on the Quote Line Item. The API names of both fields end with ImageUrl__c. If you now insert the column in the quote, the image associated with the link will be read.

If images are to be used outside of Salesforce, please configure the remote site setting for this purpose.

Warning

Custom Columns and Multilingualism

Please note that custom columns of type Picklist always map the field values in the user language. The "Multilingualism" feature is not supported here.