Versions Compared

Version Old Version 4 New Version Current
Changes made by

Phu Nguyen

Anne Krieg

Saved on

Key

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

Einführung

Produkteigenschaften mit Berechnung eignen sich dazu, Produkte im Angebot inhaltlich genauer zu spezifizieren, wobei diese Eigenschaften auch die Preiskalkulation beeinflussen.

Erstellen Sie eine neue Produkteigenschaft vom Datensatztyp "Produktoption mit Berechnung". Es öffnet sich die Maske zur Konfiguration der Produkteigenschaft:

Image Removed

Grundkonfiguration

Die genaue Grundkonfiguration gestaltet sich wie folgt:

Feldbezeichnung

API-Name

Sektion

Funktion

Produkteigenschaft Name

Name

Grundkonfiguration

Unter dieser Bezeichnung wird die Produkteigenschaft im Angebot angezeigt

Eigenschaftstyp

Note

Simplify the configuration using the Lightning Page Layout Product_Property_with_Price_Influence_Dynamic_Layout, which automatically displays the required fields for the respective property type. Assign this to the record type Produktoption_mit_Berechnung in the setup.

Introduction

Product Properties with Price Influence are suitable for specifying products in the offer more precisely in terms of content, and these properties also influence the price calculation.

Create a new product property of the record type "Product Property with Price Influence". The mask for configuring the product property opens:

Image Added

Basic Configuration

The exact basic configuration is as follows:

PflichtfeldUnsichtbarReihenfolge

Field Name

API-Name

Function

Product Property

Name

Under this name the product property is displayed in the offer

Property Type

sf42_quotefx__SF42_PropertyType__c

Grundkonfiguration

Der Eigenschaftstyp bestimmt die Art und Weise, wie die Eigenschaft im Angebotseditor abgefragt wird. Mögliche Ausprägungen sind:

  • Zahl

  • Kontrollkästchen

  • Auswahlliste

  • Datum

  • Beziehung

    • Tabelle

    The property type determines the way the property is queried in the quote editor. Possible characteristics are:

    • Number

    • Checkbox

    • Dropdown

    • Multipicklist

    • Relation

    • Table

    Preassigned Value

    sf42_quotefx__SF42_PreassignedValue__cGrundkonfiguration

    Optional, an dieser Stelle kann ein Wert vorgegeben werden, mit dem die Eigenschaft vorbelegt ist. Im Falle einer Checkbox sind die zur Verfügung stehenden Werte 'true' und at this point a value can be specified with which the property is preset. In the case of a checkbox, the available values are 'true' and 'false'.

    Unit Text

    sf42_quotefx__SF42_UnitText__c

    Grundkonfiguration

    Optional, dieser Text erscheint im Angebot hinter der Zahleingabe zur genaueren Spezifizierung, z.B. eine Maßeinheit

    Optional, this text appears in the offer after the payment input for more precise specification, e.g. a unit of measurement.

    Mandatory

    sf42_quotefx__SF42_isMandatory__cGrundkonfiguration

    Optional, wenn diese Checkbox gesetzt wird, ist es verpflichtend, die Produkteigenschaft zu spezifizieren. Andernfalls könnte sie im Produktdialog auch übergangen werden

    if this checkbox is set, it is mandatory to specify the product property. Otherwise it could also be skipped in the product dialog

    hidden

    sf42_quotefx__SF42_isHidden__c

    Grundkonfiguration

    Wenn mit If set to 'true' belegt,erscheint die Produkteigenschaft im , the product property will appear in the Quote Editor, jedoch nicht im Druck

    but not in the printout.

    Order

    sf42_quotefx__SF42_CalcOrder__cGrundkonfiguration

    Optional, bestimmt die Reihenfolge der Abfrage bei mehreren Produkteigenschaften desselben Record Types zu einem Produkt. Produkteigenschaften werden i.d.R. vom Listenpreis aus berechnet. Näheres hierzu s. im Abschnitt Kalkulation.

    Beziehungen

    Der Abschnitt Beziehungen legt die Produkte oder Produktgruppe(n) fest, auf die sich die Produkteigenschaft bezieht:

    Feldbezeichnung

    API-Name

    Sektion

    Funktion 

    Produkt

    determines the query order for multiple product properties of the same record type for a product. For more details, see the Calculation section.

    Opp Lineitem API

    sf42_quotefx__SF42_OppLiAPIfieldname__c

    Optionally, here you can define on which field of the opportunity product the determined value should be written (esp. property type Table/Relation).

    Relations

    The Relations section specifies the product(s) or product group(s) to which the product property relates:

    Kalkulation
    zusätzl. Produktgruppe 

    Field Name

    API-Name

    Function 

    Product

    sf42_quotefx__SF42_Product__c

    Beziehungen

    Auf dieses Produkt bezieht sich die Produkteigenschaft

    Produktgruppe

    The product property refers to this product

    Product Group

    sf42_quotefx__SF42_Product_Group__c

    Beziehungen

    Alternativ zur Kategorie "Produkt", kann sich die Preiskalkulation auch auf Produkte einer Produktgruppe beziehen. In diesem Fall ist kein Produkt anzugeben.

    As an alternative to the "Product" category, the price calculation can also refer to products of a product group.

    secondary Product Group

    sf42_quotefx__SF42_Product_Group_2__c

    Beziehungen

    Bezeichnet ggf. die untergeordnete Produktgruppe.
    Wichtig: Die Produkteigenschaft greift dann nur bei Produkten, die genau diese Kombination aus über- und untergeordneter Produktgruppe aufweisen

    Note

    Die Abschnitte "Grundkonfiguration" und "Beziehungen" sind für alle Eigenschaftstypen gleich auszufüllen.

    Indicates the secondary product group, if applicable.

    Important: The product property then only applies to products that have exactly this combination of parent and child product group.

    Note

    The sections "Basic Configuration" and " Relations" are to be filled in the same way for all property types.

    Calculation

    Der Abschnitt "Kalkulation" legt den Operator , den Typ (Prozent oder Betrag) sowie den Kalkulationswert der Eigenschaft fest. 

    Feldbezeichnung

    API-Name

    Sektion

    Funktion

    Wert 1 aktivWert zur Kalkulation

    FeldbezeichnungField Name

    API-Name

    SektionFunction

    Funktion

    Operator

    sf42_quotefx__SF42_calc_Operator__c

    Kalkulation

    Legt den Operator fest, und damit, ob es sich um einen Auf- oder Abschlag handelt. Zur Auswahl stehen Sets the operator, and thus whether it is a markup or markdown. The choices are + , - , =

    TypValue Type

    sf42_quotefx__SF42_calc_ValueType__c

    Kalkulation

    Bestimmt, ob es sich um einen absoluten oder relativen Wert handelt. Zur Auswahl stehen Betrag oder Prozent.

    Determines whether the value is absolute or relative. The choices are amount or percent.

    Calculation Value

    sf42_quotefx__SF42_calc_Value__c

    Kalkulation

    Mit diesem Wert wird die Eigenschaft berechnet.
    Eine Konfiguration mit dem Kalkulationswert 100, dem Operator + und Typ Betrag (€) z.B. errechnet einen Aufschlag von 100 €

    Alle drei Felder sind Pflichtfelder, näheres unten bei den einzelnen Eigenschaftstypen.

    Note

    Besonderheit beim Operator =

    Eine Produkteigenschaft mit Operator = überschreibt den Listenpreis des zugrundeliegenden Produktes mitsamt allen zuvor eingegebenen Produkteigenschaften mit Preiseinfluss. Hier spielt also die Reihenfolge der verschiedenen Eigenschaften eine Rolle!
    Produkteigenschaften mit Berechnung, die anschließend eingefügt werden, errechnen sich auf Basis des neuen Listenpreises.

    Wenn der Listenpreis eines Produktes bei 0 € liegt, wird der Wert der ersten Produkteigenschaft mit Berechnung ebenfalls auf den Listenpreis geschrieben. Sofern es weitere Eigenschaften mit Berechnung gibt, wird deren Wert wie gewohnt unter Eigenschaften ausgewiesen.

    Eigenschaftstypen

    Warning

    Hinweis zur Umstellung auf appero quote Lightning

    Sofern Sie appero quote bereits in einer älteren Version installiert haben, gilt es beim Update auf Version 19.1000 zu überprüfen, ob die Benutzer vollständigen Zugriff auf die folgenden Eigenschaftstypen haben. Ggf. sind diese sonst im je Datensatztyp bei den Auswahllisten-Werten zu ergänzen

    Eigenschaftstyp Zahl

    Die Spezifizierung der Eigenschaft vom Typ  "Zahl" erfolgt in der Sektion "Zusätzlich für Zahl".

    Für den Eigenschaftstyp "Zahl" sind folgende Felder auszufüllen:

    This value is used to calculate the property. For example, a configuration with the calculation value 100, the operator + and type Amount (€) calculates a markup of 100 €

    All three fields are mandatory, see the individual property types below for more details.

    Note

    Special feature of the operator =

    A product property with operator = overwrites the list price of the underlying product together with all previously entered product properties with price influence. So here the order of the different properties plays a role! Product Properties with Price Influence, which are inserted afterwards, are calculated on the basis of the new list price.

    Property types

    Property type “Number”

    The specification of the "Number" type property is done in the "Additional for Number" section. The following fields are to be filled in here:

    Wert

    Field Name

    API-Name

    Function

    Example

    Value 1 enabled

    sf42_quotefx__SF42_Value1Enabled__c

    Zusätzlich für Zahl

    Pflichtfeld, um eine Zahl abfragen zu können, muß Wert 1 aktiv sein.
    Wert 1 wird zur Berechnung der Eigenschaft herangezogen und im Angebotsprozess vergeben.

    Mandatory field, to be able to query a number, value 1 must be active

    		Image Added

    Value 1 minimum

    sf42_quotefx__SF42_Value1Min__c

    Zusätzlich für Zahl

    Optional,

    an dieser Stelle kann eine Untergrenze definiert werden. Wert

    at this point a lower limit can be defined

    2

    Value 1 maximum

    sf42_quotefx__SF42_Value1Max__c

    Zusätzlich für Zahl

    Optional, an

    dieser Stelle kann eine Obergrenze definiert werdenWert 2 aktiv

    upper limit can be defined at this point

    15

    Value 2 enabled

    sf42_quotefx__SF42_Value2Enabled__c

    Zusätzlich für Zahl

    Optional,

    mit dieser Checkbox kann ein weiteres Zahlenfeld aktiviert werden. Dieses spielt für die Berechnung allerdings keine Rolle.Wert Wert

    with this checkbox another number field can be activated

    Value 2 minimum

    sf42_quotefx__SF42_Value2Max__c

    Zusätzlich für Zahl

    s.o.

    see above

    Value 2 maximum

    sf42_quotefx__SF42_Value2Min__c

    Zusätzlich für Zahl

    s.o.

     Kalkulationslogik Eigenschaftstyp Zahl
    Note

    Für die Produkteigenschaft mit Berechnung vom Typ "Zahl" werden sowohl der Kalkulationswert als auch der im Angebotsprozess vergebene "Wert 1" herangezogen.

    Operator

    Typ

    Bsp.
    Kalkulationswert

    Bsp.
    Wert 1

    Bsp. Preisbucheintrag Produkt
    (PBE)

    Berechnung der Produkteigenschaft 

    Bsp. errechneter 
    Wert der Eigenschaft

    Endpreis im Angebot

    Bsp.
    Endpreis

    see above

    Calculation logic property type “Number”

    Note

    For the product property with calculation of the type "Number", both the calculation value and the "Value 1" assigned in the quoting process are used.

    Operator

    Type

    Example

    Calculation Value

    Example

    Value 1

    Example

    Price Book Entry product (PBE)

    Product property calculation

    Example

    Calculated Value of property

    End price in the quote

    Example
    End price

    =

    %

    10

    25

    1000

    = (PBE/100 * Kalkulationswert Calculation Value * Wert Value 1)

    0Wert der Eigenschaft überschreibt Listenpreis

    Value of the property overwrites list price

    2500

    +

    %

    10

    25

    1000

    + (PBE/100 * Kalkulationswert Calculation Value * Wert Value 1)

    2500

    PBE + Wert der EigenschaftValue of property

    3500

    -

    %

    10

    25

    1000-

    • (PBE/100 *

    Kalkulationswert

    • Calculation Value *

    Wert

    • Value 1)

    -2500

    PBE - Wert der EigenschaftValue of property

    -1500

    =

    €

    10

    25

    1000

    = (10 * 25)

    0Wert der Eigenschaft überschreibt Listenpreis

    Value of the property overwrites list price

    250

    +

    €

    10

    25

    1000

    + (10 * 25)

    250

    PBE + Wert der EigenschaftValue of property

    1250

    -

    €

    10

    25

    1000-

    • (10 * 25)

    -250

    PBE - Wert der EigenschaftValue of property

    750

    Die weiteren Abschnitte "Zusätzlich für Auswahlliste/Mehrfachauswahlliste" sowie "Zusätzlich für Beziehung/Tabelle" spielen für den Typ "Zahl" keine Rolle.

    Eigenschaftstyp Kontrollkästchen

    Mit dem Eigenschaftstyp  "Kontrollkästchen" können Sie eine Checkbox als Produkteigenschaft einfügen. Erst, wenn dieses gesetzt wird, greift die im Abschnitt 'Kalkulation' definierte Berechnung. 

    Die Abschnitte - "Zusätzlich für Auswahlliste/Mehrfachauswahlliste", "Zusätzlich für Beziehung/Tabelle" und "Zusätzlich für Zahl" - spielen für den Typ "Checkbox" keine Rolle. 

    Eigenschaftstyp Auswahlliste 

    Hier müssen zur Auswahl stehenden Ausprägungen im Feld "Auswahllisten Werte" - durch Kommas getrennt, ohne Leerzeichen - hinterlegt werden. Parallel dazu im Feld "Auswahllisten Kalkulationswerte" die damit verbundenen Rechenwerte.

    Feldbezeichnung

    API-Name

    Sektion

    Funktion

    Auswahllisten Werte

    The sections - "Additional for Dropdown/Multipicklist", "Additional for Relation/Table" - do not matter for type "Number".

    Property type “Checkbox”

    With the property type "Checkbox" you can insert a checkbox as a product property. Only when this is set does the calculation defined in the “Calculation” section take effect.

    The sections - "Additional for Dropdown/Multipicklist", "Additional for Relation/Table" and "Additional for Number" - are irrelevant for the "Checkbox" type.

    Property type “Dropdown” 

    The specification of the "Dropdown" type property is done in the "Additional for Dropdown/Multipicklist" section. Here, the values available for selection must be entered in the "Dropdown Values" field - separated by commas, without spaces. At the same time, the associated calculation values must be entered in the "Dropdown Calculation" field.

    Field Name

    API-Name

    Function

    Dropdown Values

    sf42_quotefx__SF42_DropdownValues__c

    Zusätzlich für Auswahlliste/Mehrfachauswahlliste

    Erfasst die zur Auswahl stehenden Ausprägungen, z.B. Größe, Farbe, LängeCaptures the characteristics available for selection, e.g. size, color, length...

    Auswahllisten KalkulationswerteDropdown Calculation

    sf42_quotefx__SF42_DropdownCalc__c

    Zusätzlich für Auswahlliste/Mehrfachauswahlliste

    Mit diesem Wert und den im Bereich 'Kalkulation' angegebenen Operator und Typen wird die Eigenschaft berechnet.

    Eine Konfiguration aus + 100 € errechnet einen Aufschlag von With this value and the operators and types specified in the “Calculation” area, the property is calculated.

    A configuration of + 100 € calculates a markup of 100 €

    Note

    Das Feld The field sf42_quotefx__SF42_DropdownCalc__c sticht den unter "Kalkulation" eingegebenen "Kalkulationswert". Dieser spielt für die Berechnung dieses Typs keine Rolle und sollte mit "0" belegt werden, um Irritationen zu vermeiden.

    Kalkulationslogik für Typ Auswahlliste und Kontrollkästchen

    c stamps the "Calculation Value" entered under "Calculation". This plays no role for the calculation of this type and should be filled with "0" to avoid irritations.

    Calculation logic for type “Dropdown” and “Checkbox”

    Operator

    Typ

    Bsp. Preisbucheintrag
    Produkt Example

    Price Book Entry product (PBE)

    Bsp.
    Kalkulationswert

    Berechnung der Produkteigenschaft

    Bsp. errechneter Wert der Produkteigenschaft

    Endpreis im Angebot

    Bsp.
    EndpreisExample

    Calculation Value

    Product property calculation

    Example

    Calculated Value of property

    End price in the quote

    Example

    End price

    =

    %

    75.000

    50

    PBE/100 * KalkulationswertCalculation Value

    0Wert der Produkteigenschaft überschreibt Listenpreis

    Value of the property overwrites list price

    37.500

    +

    %

    75.000

    50

    PBE/100*KalkulationswertCalculation Value

    37.500

    PBE + Wert der ProdukteigenschaftValue of property

    112.500

    -

    %

    75.000

    50-

    • (PBE/100*

    Kalkulationswert

    • Calculation Value)

    -37.500

    PBE - Wert der ProdukteigenschaftValue of property

    -37.500

    =

    €

    75.000

    50Kalkulationswert

    Calculation Value

    0Wert der Produkteigenschaft überschreibt Listenpreis

    Value of the property overwrites list price

    50

    +

    €

    75.000

    50Kalkulationswert

    Calculation Value

    50

    PBE + Wert der ProdukteigenschaftValue of property

    75.050

    -

    €

    75.000

    50-Kalkulationswert

    • Calculation Value

    -50

    PBE - Wert der ProdukteigenschaftValue of property

    74.950

    Eigenschaftstyp Beziehung und Tabelle

    s. Verwendung von Object Queries

    Anzeige im Angebotseditor

    Produkteigenschaften mit Berechnung werden im Angebotseditor beim Einfügen des Produkts abgefragt und können auch später über den Produkt-Detail-Dialog bearbeitet werden:

    Die Summe der errechneten Eigenschaften wird im Produkt-Detail-Dialog in einer eigenen Spalte ausgewiesen:

    Image Removed NoteUser mit der Berechtigung "appero quote Admin" können über den Namen der Produkteigenschaft auf den zugehörigen Datensatz in Salesforce navigieren. Die Produkteigenschaft öffnet in einem neuen Tab, so dass der Angebotsprozess nicht unterbrochen wird.
    Image Removed

    Im Angebot selbst erscheinen die Produkteigenschaften in einer eigenen Zeile, in der auch der Kalkulationswert separat aufgeführt wird:

    Image Removed

    Property type “Relation” and “Table”

    See Use of Object Queries

    Display in quote editor

    Product Properties with Price Influence are requested in the quote editor when inserting the product and can also be edited later via the Product Details dialog:

    The sum of the calculated properties is shown in a separate column in the product detail dialog:

    Image Added

    In the quote itself, the product properties appear in a separate line, where the calculation value is also listed separately:

    Image Added
    Note

    Users with the "appero quote Admin" permission can navigate to the associated record in Salesforce via the name of the product property. The product property opens in a new tab so that the quote process is not interrupted:

    Image Added