Allgemeine Informationen
Eine Positionsvorlage dient dazu, Inhalte und Details einer Positionskalkulation in ein Angebot einzufügen. Bei der Erstellung eines Angebots, welches Positionskalkulationen beinhaltet, muss eine Positionsvorlage gewählt werden. Positionsvorlagen nehmen mehrere MS Word Dateien auf, welche als sog. Positionszeilenvorlagen und als Vorlagen für den Gesamtsummenbereich einer Positionskalkulation verwendet werden. Positionstypen, für die keine Positionszeilenvorlage hinterlegt ist, tauchen in der zugehörigen Positionskalkulation im Angebot nicht auf.
Die Generierung von Positionskalkulationen in Angeboten mithilfe einer Positionsvorlage basiert auf der Verwendung von Tabellen in den entsprechenden Zeilenvorlagen.
Nach der Ersetzung aller Platzhalter wird die letzte Tabelle der ersten verwendeten Zeilenvorlage vollständig an der aktuellen Position im Angebot eingefügt.
Für alle folgenden Positionen wird nur noch die letzte Zeile der letzten Tabelle im Speicher kopiert, die Platzhalter ersetzt und die resultierende Zeile an zuvor im Angebot erstellte Tabelle angehängt.
Dieses Vorgehen setzt voraus, dass das Layout aller Tabellen in den Zeilenvorlagen mehr oder weniger identisch ist, da sonst die resultierende Tabelle im Angebot verzerrt dargestellt werden kann.
Die Anzahl und Breite der verwendeten Spalten beispielsweise muss identisch sein, es ist aber möglich in unterschiedlichen Zeilenvorlagen verschiedene Tabellenzellen zusammenzufassen, ohne das Gesamtlayout zu zerstören.
Aktionen
Zusätzlich zu den allgemeine Aktionen in Masken steht Ihnen in der Tabellenkalkulationsvorlage die folgende Aktion zur Verfügung.
| Aktion | Beschreibung |
|---|---|
| Platzhalter | Zeigen Sie einfache Platzhalter an, die sie mit Copy&Paste in die Zeilenvorlagen übernehmen können. |
| Kopieren | Kopieren Sie die ausgewählte Vorlage. |
| Neue Standardpositionszeilenvorlage | Erstellt eine neue Vorlagendatei für den entsprechenden Vorlagentypen. Die Datei wird im Anschluss zur Bearbeitung geöffnet und als Anhang im zugehörigen Anhangsfeld der Positionsvorlage hinzugefügt. Ein bestehender Anhang muss zunächst gelöscht werden, bevor die Aktion erneut ausgeführt werden kann. |
| Neue Alternativpositionszeilenvorlage | Erstellt eine neue Vorlagendatei für den entsprechenden Vorlagentypen. Die Datei wird im Anschluss zur Bearbeitung geöffnet und als Anhang im zugehörigen Anhangsfeld der Positionsvorlage hinzugefügt. Ein bestehender Anhang muss zunächst gelöscht werden, bevor die Aktion erneut ausgeführt werden kann. |
| Neue Freitextzeilenvorlage | Erstellt eine neue Vorlagendatei für den entsprechenden Vorlagentypen. Die Datei wird im Anschluss zur Bearbeitung geöffnet und als Anhang im zugehörigen Anhangsfeld der Positionsvorlage hinzugefügt. Ein bestehender Anhang muss zunächst gelöscht werden, bevor die Aktion erneut ausgeführt werden kann. |
| Neue Rabattzeilenvorlage | Erstellt eine neue Vorlagendatei für den entsprechenden Vorlagentypen. Die Datei wird im Anschluss zur Bearbeitung geöffnet und als Anhang im zugehörigen Anhangsfeld der Positionsvorlage hinzugefügt. Ein bestehender Anhang muss zunächst gelöscht werden, bevor die Aktion erneut ausgeführt werden kann. |
| Neue Zwischensummenzeilenvorlage | Erstellt eine neue Vorlagendatei für den entsprechenden Vorlagentypen. Die Datei wird im Anschluss zur Bearbeitung geöffnet und als Anhang im zugehörigen Anhangsfeld der Positionsvorlage hinzugefügt. Ein bestehender Anhang muss zunächst gelöscht werden, bevor die Aktion erneut ausgeführt werden kann. |
| Neue Gesamtsummenvorlage | Erstellt eine neue Vorlagendatei für den entsprechenden Vorlagentypen. Die Datei wird im Anschluss zur Bearbeitung geöffnet und als Anhang im zugehörigen Anhangsfeld der Positionsvorlage hinzugefügt. Ein bestehender Anhang muss zunächst gelöscht werden, bevor die Aktion erneut ausgeführt werden kann. |
Felder
| Feld | Beschreibung |
|---|---|
| Name | Geben Sie einen Namen für diese Vorlage an. Sie wählen später die Vorlage nach den Tags oder dem Namen aus. |
| Aktiv | Wählen Sie, ob diese Vorlage zur Auswahl angeboten wird und in den Vorlange-Ansichten angezeigt wird. |
| Tags | Wählen oder vergeben Sie Tags, um die Briefvorlagen besser zu organisieren. Ordnen Sie beispielsweise allen Standardbriefvorlagen und allen Angebotsvorlagen jeweils einen gemeinsamen Tag zu. |
| Beschreibung | Beschreiben Sie den Inhalt und den Einsatzzweck dieser Briefvorlage. Diese Informationen können später helfen, die richtige Briefvorlage auszuwählen. |
| Standardpositionszeilenvorlage | Bearbeiten Sie die angehängte Zeilenvorlage. Sie können diese auch entfernen und beispielsweise aus einer lokalen Datei oder über die zugehörige Aktion neu erzeugen. |
| Alternativpositionszeilenvorlage | Bearbeiten Sie die angehängte Zeilenvorlage. Sie können diese auch entfernen und beispielsweise aus einer lokalen Datei oder über die zugehörige Aktion neu erzeugen. |
| Freitextzeilenvorlage | Bearbeiten Sie die angehängte Zeilenvorlage. Sie können diese auch entfernen und beispielsweise aus einer lokalen Datei oder über die zugehörige Aktion neu erzeugen. |
| Rabattzeilenvorlage | Bearbeiten Sie die angehängte Zeilenvorlage. Sie können diese auch entfernen und beispielsweise aus einer lokalen Datei oder über die zugehörige Aktion neu erzeugen. |
| Zwischensummenzeilenvorlage | Bearbeiten Sie die angehängte Zeilenvorlage. Sie können diese auch entfernen und beispielsweise aus einer lokalen Datei oder über die zugehörige Aktion neu erzeugen. |
| Gesamtsummenvorlage | Bearbeiten Sie die angehängte Zeilenvorlage. Sie können diese auch entfernen und beispielsweise aus einer lokalen Datei oder über die zugehörige Aktion neu erzeugen. |
Platzhalter
Die Platzhalter greifen auf einen Datensatz zu und können relativ zu dem aktuellen Datensatz Daten ausgelesen. Hier eine Liste der möglichen Quelldatensätze, die verwendet werden können.
| Parameter | Quelldatensatz |
|---|---|
| source | Aktueller Datensatz |
| parent | Quelldatensatz des aktuellen Datensatzes |
| firstFoundContact | Erster gefundene Kontakt des aktuellen Datensatzes |
| firstFoundCompany | Erste gefundene Firma des aktuellen Datensatzes |
| firstFoundAddress | Erster gefundene Adresse (Firma, Kontakt oder Einmalteilnahme zu einer Veranstaltung) des aktuellen Datensatzes |
| appConfig | Anwendungseinstellungen |
| userConfig | Benutzereinstellungen des aktuellen Benutzers |
| userProfile | Benutzerprofil des aktuellen Benutzers |
| offer | Der Angebotsdatensatz während der Erstellung eines Angebots, in dieser Situation identisch mit ‘source’ |
| opportunity | Die Verkaufschance während der Erstellung eines Angebots, in dieser Situation identisch mit ‘parent’ |
| quote | Der jeweilige Kalkulationsdatensatz während der Erstellung eines Angebots |
| template | Die gewählte Positionsvorlage während der Erstellung eines Angebots mit Positionskalkulationen (nur gültig in Positionsvorlagen) |
| position | Die aktuell verarbeitete Position während der Erstellung eines Angebots mit Positionskalkulationen (nur gültig in Positionsvorlagen) |
In den meisten Fällen wird ein Platzhalter immer auf eine bestimmte Information (z.B. eine Datenspalte oder einen Anhang) aus dem Quelldatensatz zugreifen. Hierzu wird die jeweilige Information durch einen Punkt getrennt an die Datenquelle angehängt. Eine ausführliche Beschreibung finden Sie im technischen Handbuch im Unterkapitel “Berechnete Eigenschaften” von Platzhaltern.
Hier sind die wichtigsten Platzhalter aufgeführt:
Die Variable position verweist auf eine Position innerhalb einer Kalkuation.
{ DOCVARIABLE position.PositionNumberUi \* MERGEFORMAT} gibt die Nummer der Postion aus. Die konfigurierte Sichtbarkeit wird berücksichtigt.
{ DOCVARIABLE position.Icon max-width=“80” max-height=“80” \* MERGEFORMAT} zeigt das Bild der Postion in der Größe 80×80 Pixel an.
{ DOCVARIABLE position.Name \* MERGEFORMAT} gibt den Namen der Postion aus.
{ DOCVARIABLE position.NumberOf format=”#,#0” \* MERGEFORMAT} gibt die in der Postion hinterlegte Menge aus.
{ DOCVARIABLE position.PriceOfferCurUi format=”#,#0.00” \* MERGEFORMAT} gibt die in der Postion hinterlegte Einzelpreis aus. Die konfigurierte Sichtbarkeit wird berücksichtigt.
{ DOCVARIABLE position.Discount format=”#,#0.00” \* MERGEFORMAT} gibt den in der Postion hinterlegten Rabatt als Geldbetrag aus.
{ DOCVARIABLE position.DiscountPercentage \* MERGEFORMAT} gibt den in der Postion hinterlegten Rabatt als Prozentwert aus.
{ DOCVARIABLE position.TotalOfferCur format=”#,#0.00” \* MERGEFORMAT} gibt den in der Postion hinterlegten Betrag aus.
{ DOCVARIABLE position.Cpp_GetDesctionValue fieldName=“ShortText” language=“de” \* MERGEFORMAT} gibt den Kurztext in Deutsch der Postion aus.
{ DOCVARIABLE position.Cpp_GetDesctionValue fieldName=“LongText” language=“de” type=“html” \* MERGEFORMAT} gibt den Langtext in Deutsch der Postion aus als HTML.
{ DOCVARIABLE position.TotalOfferCur language=“de” format=”#,#0.00” \* MERGEFORMAT} gibt den Gesamtbetrag mit 2 Nachkommastellen aus.
{ DOCVARIABLE position.DiscountPercentage \* MERGEFORMAT} gibt den Rabatt der der Position aus.
Die Variable quote verweist auf eine Kalkulation.
{ DOCVARIABLE quote.Cpq_GetTaxBlock renderType=“text” inlcude=“label,taxrate,taxedsum” label=“MwSt.” taxRateFormat=“N1” taxedSumFormat=”#,#0.00”} gibt die Beschreibung der Steuersätze aus.
{ DOCVARIABLE quote.Cpq_GetTaxBlock renderType=“values” valuesFormat=”#,#0.00”} gibt die Steuerbeträge aus.
{ DOCVARIABLE quote.TotalSumOfferCur language=“de” format=”#,#0.00”} gibt die Angebotswährung der Kalkulation als ISO Code aus.
{ DOCVARIABLE quote.OfferCurrencyIsoCode} gibt die Angebotswährung der Kalkulation als ISO Code aus.
Alle Kalkulationstypen “Excel-Kalkulation”, “Positionskalkuation” und “Proalpha-Kalkuation” enthalten ein festes Set an Feldern, um sie gemeinsam auswerten zu können.
Auf dieses Set an Feldern kann entweder über die Variable quoteTotal für alle Kalkuationen addiert zugegriffen werden oder über die Variable quoteSubTotal für nur eine Kalkuation.
Variable quoteTotal
{ DOCVARIABLE quoteTotal.SumOfferCur format=”#,#0.00” } gibt die Angebotssumme in der Angebotswährung aus.
{ DOCVARIABLE quoteTotal.DiscountOfferCur format=”#,#0.00” } gibt den Angebotsrabatt in der Angebotswährung aus.
{ DOCVARIABLE quoteTotal.DiscountSumOfferCur format=”#,#0.00” } gibt die Angebotsnettosumme in der Angebotswährung aus.
{ DOCVARIABLE quoteTotal.SumTaxesOfferCur format=”#,#0.00 } gibt die Steuer in der Angebotswährung aus.
{ DOCVARIABLE quoteTotal.TotalSumOfferCur format=”#,#0.00” } gibt die Angebotsbruttosumme in der Angebotswährung aus.
{ DOCVARIABLE quoteTotal.Sum format=”#,#0.00” } gibt die Angebotssumme in der Hauswährung aus.
{ DOCVARIABLE quoteTotal.Discount format=”#,#0.00” } gibt den Angebotsrabatt in der Hauswährung aus.
{ DOCVARIABLE quoteTotal.DiscountSum format=”#,#0.00” } gibt die Angebotsnettosumme in der Hauswährung aus.
{ DOCVARIABLE quoteTotal.SumTaxes format=”#,#0.00”} gibt die Steuer in der Hauswährung aus.
{ DOCVARIABLE quoteTotal.TotalSum format=”#,#0.00” } gibt die Angebotsbruttosumme in der Hauswährung aus.
Variable quoteSubTotal
{ DOCVARIABLE quoteSubTotal.SumOfferCur format=”#,#0.00” } gibt die Angebotssumme in der Angebotswährung aus.
{ DOCVARIABLE quoteSubTotal.DiscountOfferCur format=”#,#0.00” } gibt den Angebotsrabatt in der Angebotswährung aus.
{ DOCVARIABLE quoteSubTotal.DiscountSumOfferCur format=”#,#0.00” } gibt die Angebotsnettosumme in der Angebotswährung aus.
{ DOCVARIABLE quoteSubTotal.SumTaxesOfferCur format=”#,#0.00 } gibt die Steuer in der Angebotswährung aus.
{ DOCVARIABLE quoteSubTotal.TotalSumOfferCur format=”#,#0.00” } gibt die Angebotsbruttosumme in der Angebotswährung aus.
{ DOCVARIABLE quoteSubTotal.Sum format=”#,#0.00” } gibt die Angebotssumme in der Hauswährung aus.
{ DOCVARIABLE quoteSubTotal.Discount format=”#,#0.00” } gibt den Angebotsrabatt in der Hauswährung aus.
{ DOCVARIABLE quoteSubTotal.DiscountSum format=”#,#0.00” } gibt die Angebotsnettosumme in der Hauswährung aus.
{ DOCVARIABLE quoteSubTotal.SumTaxes format=”#,#0.00”} gibt die Steuer in der Hauswährung aus.
{ DOCVARIABLE quoteSubTotal.TotalSum format=”#,#0.00” } gibt die Angebotsbruttosumme in der Hauswährung aus.
Allgemeine Variablen
{ DOCVARIABLE opportunity.OfferCurrencyIsoCode} Gibt die Angebotswährung der Verkaufschance als ISO Code aus.
{ DOCVARIABLE opportunity.Currency.Symbol } Gibt die Angebotswährung der Verkaufschance als Symbol Code aus.
{ DOCVARIABLE appConfig.DomesticCurrency.ISOCode} Gibt die Hauswährungals ISO Code aus.
{ DOCVARIABLE appConfig.DomesticCurrency.Symbol} Gibt die Angebotswährung der Verkaufschance als ISO Code aus.
{ DOCVARIABLE source.ValidUntil format=“date”} Gibt das “Gültig bis” Datum des Angebots aus.
{ DOCVARIABLE source.subject} Gibt den Betreff des Angebots aus.
{ DOCVARIABLE source.UniqueNumber} Gibt die Nummer des Angebots aus.
{ DOCVARIABLE source.ActivityDate format=“date”} Gibt die Angebotsdatum aus.