Scripting / Platzhalter
Bei der Konfiguration von UniERM können Sie in einigen Webparts und Ereignissen das UniERM Scripting / Platzhaltersystem verwenden. Beispiele dafür sind das PDFErzeugen.dll (Dateiname), E-Mail-Versandereignis oder die Optionswebparts Nummernkreise, Konfiguration Preissystem und Konfiguration der Vorgangstypen.
Nachfolgend ist ein Teil der Möglichkeiten beschrieben.
Platzhalter
Platzhalter für Vorgangsinformationen
Sie können Platzhalter verwenden, die von UniERM ersetzt werden. Platzhalter beginnen grundsätzlich mit "%Vorgang." und enden mit "%". Dazwischen können Sie den Namen einer beliebigen Vorgangseigenschaft eingeben, die in eine Zeichenkette konvertiert werden kann. Hierfür ist tiefergehendes UniERM-Wissen notwendig. Über das Entwickler-SDK erhalten Sie alle benötigten Informationen. Oder fragen Sie uns.
Weiterhin können Sie für den Ansprechpartner, die Vorgangsadresse, Lieferadresse, Rechnungsadresse und Firmenstammadresse anstelle der am Vorgang hinterlegten Informationen die Live-Werte der jeweiligen Adresse abrufen. Der Platzhalter beginnt dann mit "%Vorgang.Ansprechpartner.", endet mit "%" und enthält dazwischen eine Adresseigenschaft. Die Live-Informationen können notwendig sein, wenn Sie beispielsweise eine E-Mail nach einem längeren Zeitraum automatisch versenden lassen und sich in der Zwischenzeit die E-Mail-Adresse geändert hat. In dem Fall ist am Vorgang die zum damaligen Zeitpunkt gültige hinterlegt, nicht die aktuelle.
Ein kleiner Auszug der Möglichkeiten gibt Ihnen die folgende Tabelle:
Platzhalter | Wert |
|---|---|
%Vorgang.Adresse_Anrede_Bezeichnung% | Die Anrede der verwendeten Hauptadresse. |
%Vorgang.Adresse_Titel_Bezeichnung% | Der Titel der verwendeten Adresse. |
%Vorgang.Adresse_Name1% | Der erste Name der verwendeten Hauptadresse. |
%Vorgang.Adresse_Name2% | Der zweite Name der verwendeten Hauptadresse. |
%Vorgang.Adresse_Name3% | Der dritte Name der verwendeten Hauptadresse. |
%Vorgang.Ansprechpartner_Email% | Die E-Mail-Adresse des Ansprechpartners der Hauptadresse, die am Vorgang hinterlegt ist. Sie können alternativ die ggf. aktualisierte E-Mail-Adresse des Ansprechpartners abrufen: |
%Vorgang.Ansprechpartner.Email% | Die aktuelle E-Mail-Adresse des am Vorgang hinterlegten Ansprechpartners. Beachten Sie, dass Sie den Punkt-Operator zum Abgreifen von Live-Informationen ausschließlich für die nachfolgenden fünf am Vorgang hinterlegten Adressen nutzen können: Ansprechpartner, Vorgangsadresse, Lieferadresse, Rechnungsadresse, Firmenstammadresse. |
%Vorgang.VerwendeteBriefanrede_Bezeichnung% | Die Bezeichnung der Briefanrede der verwendeten Hauptadresse. |
%Vorgang.VorgangsPositionen% | Gibt alle Vorgangspositionen mit dem Artikelkurztext und der Menge aus. Weitere Informationen, inklusive einer Möglichkeit die Ausgabe individuell zu gestalten, finden Sie hier. |
%Vorgang.StatusHistorie% | Gibt eine Statushistorie wie das gleichnamige Webpart mit Statuswechseldatum und Statusbezeichnung zurück. |
%Vorgang.VorgangsNr% | Dieser Platzhalter wird durch die Vorgangsnummer ersetzt. |
%Vorgang.Fertigstelldatum.yyyyMMdd.true% | Der Platzhalter wird durch das Fertigstelldatum ersetzt und nach dem Schema yyyyMMdd formatiert. Sie können jedes beliebige Datum nach Ihren Vorstellungen formatieren, indem Sie das Formatierungsschema mit einem Punkt von der Datumsbezeichnung abtrennen sowie mit ".true" nach dem Schema. |
Ein Beispiel für die Benennung von einem Rechnungsbeleg:
Re_%Vorgang.Adresse_Debitorennummer%_%Vorgang.VorgangsNr%_ %Vorgang.Fertigstelldatum.yyyyMMdd.true%
Platzhalter: Individuelle Vorgangspositionsliste
Sie können anstelle der Standarddefinition des Platzhalters %Vorgang.VorgangsPositionen% die Positionsliste komplett individuell konfigurieren:
%Vorgang.VorgangsPositionen%
%Vorgang.VorgangsPositionenErweitert%
Beide Platzhalter geben das selbe zurück. Der Platzhalter %Vorgang.VorgangsPositionenErweitert% lässt sich jedoch anpassen, indem Sie im Anschluss mit einem Punkt separiert eine eigene Ausgabe vorgeben:
%Vorgang.VorgangsPositionenErweitert._TT:_LZ:_AK:_TT:_LZ:Menge:_LZ:_MM:_BR:%
Hier werden die Vorgangspositionen wie folgt ausgegeben:
- Zuerst ein Tabulator (_TT:)
- Dann folgt ein Leerzeichen (_LZ:)
- Der Artikelkurztext (_AK:)
- Ein Tabulator (_TT:)
- Dann folgt ein Leerzeichen (_LZ:)
- Die Zeichenkette "Menge"
- Gefolgt von einem Leerzeichen (_LZ:)
- Die Menge der Position (_MM:)
- Und zum Schluss ein Zeilenumbruch (_BR:)
Diese Ausgabe entspricht somit der Standardausgabe.
Nachfolgend werden alle Möglichkeiten zur Formatierung der Positionslistenausgabe beschrieben.
Bitte beachten Sie, dass ebenfalls eine Formatierung mit HTML möglich ist.
Mit Hilfe des Skriptingsystems in Abhängigkeit vom Vorgangstyp die Ausgabe der Positionsliste unterschiedlich gestaltet werden kann. Ein Beispiel finden Sie am Ende der Seite.
Positionswerte
Platzhalter | Positionswert |
|---|---|
_AK: | |
_AL: | |
_PN: | Einzelnettopreis |
_PB: | Einzelbruttopreis |
_PM: | Mehrwertsteuer für die Menge 1 |
_PNG: | Nettosumme der Position |
_PBG: | Bruttosumme der Position |
_PMG: | Gesamtmehrwertsteuer der Position |
_PMP: | Prozentsatz der Mehrwertsteuer |
_MM: | Artikelmenge |
Platzhalter für Zeichen und Umbrüche
Platzhalter | Zeichen |
|---|---|
_TT: | |
_BR: | |
_LZ: | |
_SK: | Semikolon; |
_PP: | Punkt. |
_DP: | Doppelpunkt: |
_PRZ: | Prozentzeichen % |
_HK: | Hochkomma / Apostroph ' |
_AZ: | Anführungszeichen " |
Platzhalter für HTML
Platzhalter | HTML |
|---|---|
_BRH: | Zeilenumbruch <br /> |
_LZH: | Geschütztes Leerzeichen |
_TRA: | HTML-Tabelle TR-Anfang <TR> |
_TRZ: | HTML-Tabelle TR-Ende </TR> |
_TDA: | HTML-Tabelle TD-Anfang <TR> |
_TDZ: | HTML-Tabelle TD-Ende </TR> |
_FTA: | HTML: Fett, Anfang <b> |
_FTZ: | HTML: Fett, Ende </b> |
_KA: | HTML: Kursiv, Anfang <i> |
_KE: | HTML: Kursiv, Ende </i> |
_UA: | HTML: Unterstrichen, Anfang <u> |
_UE: | HTML: Unterstrichen, Ende </u> |
Ein Beispiel für die Ausgabe als Tabelle finden Sie auf der Seite zum Emailversandergeignis.
Platzhalter: Stammbaum durchgehen
Sie können den Stammbaum beliebig nach oben durchgehen mit dem ".Parent"-Platzhalter. Es sind alle Platzhalter verwendbar, die unmittelbar nach "%Vorgang." verwendbar sind, inkl. ".Parent"
Platzhalter | Wert |
|---|---|
%Vorgang.Adresse_Name1% | Der erste Name der verwendeten Hauptadresse. |
%Vorgang.Parent.Adresse_Name1% | Der erste Name der verwendeten Hauptadresse des Vatervorgangs. |
%Vorgang.Parent.Parent.Adresse_Name1% | Der erste Name der verwendeten Hauptadresse des Großvatervorgangs im Stammbaum. |
Bitte beachten Sie, dass der Platzhalter nur einen Wert enthält, wenn "Adresse_Name1" im Vorgang gefüllt ist und es im Stammbaum einen Vorgang vor dem aktuellen Vorgang ("%Vorgang.") gibt.
In der Regel unterstützt UniERM Sie beim Schreiben von Scripten mit einer Autovervollständigung. Diese ist standardmäßig für den ".Parent"-Platzhalter deaktiviert. Stattdessen erhalten Sie folgenden Hinweis: %Vorgang.Parent.!Vorgangseigenschaften!% - Sie können sämtliche Vorgangseigenschaften verwenden.
Live-Daten-Platzhalter
Sie könne viele Live-Daten abfragen, die der jeweilige Vorgang referenziert. Dazu gehören:
- Vorgangstyp
- Sprache
- Währung
- Verkaufsfaktor
- Lieferart
- Lieferbedingung
- Zahlungsart
- Zahlungsbedingung
Die nachfolgende Tabelle gibt eine Auswahl der Möglichkeiten. Über die automatische Vervollständigungsfunktion können Sie beim Schreiben Ihrer Skripte viele weitere abfragbare Werte finden.
Platzhalter | Wert |
|---|---|
%Vorgang.Vorgangstyp.Bezeichnung% | Über %Vorgang.Vorgangstyp können Sie alle Eigenschaften des Vorgangstyps des aktuellen Vorgangs abfragen. Zum Beispiel die Bezeichnung, ob es sich um einen Vorgang mit Debitoren- oder Kreditorenrechnung handelt oder ob dem Lager Ware hinzugeführt wird... |
%Vorgang.Sprache.Bezeichnung% | Die Bezeichnung der Vorgangssprache. |
%Vorgang.Waehrung.Bezeichnung% | Über %Vorgang.Waehrung können Sie alle Eigenschaften der Vorgangswährung des aktuellen Vorgangs abfragen. Zum Beispiel die Bezeichnung, den aktuell hinterlegten Umrechnungsfaktor zur Standardwährung, den ISO-Code und das Währungszeichen. |
%Vorgang.Verkaufsfaktor.Bezeichnung% | Die Bezeichnung des Verkaufsfaktors oder der Verkaufsfaktor selbst des Vorgangs. |
%Vorgang.Lieferart.Bezeichnung% | Die Bezeichnung der Lieferart des Vorgangs. |
%Vorgang.Lieferbedingung.Bezeichnung% | Die Bezeichnung / Bezeichnung im Report der Lieferbedingung des Vorgangs. |
%Vorgang.Zahlungsart.Bezeichnung% | Die Bezeichnung der Zahlungsart des Vorgangs. |
%Vorgang.Zahlungsbedingung.Bezeichnung% | Die Bezeichnung / Reportbezeichnung / der Skonto [%] / Zahlungsziel für Skonto [Tage] / das Zahlungsziel [Tage] des Vorgangs. |
Live-Daten-Platzhalter: Adresse
Wie oben an Beispielen gezeigt, können Sie statt der am Vorgang hinterlegten Daten die aktuellen Adressdaten verwenden. Verwenden Sie dazu folgende Platzhalter:
- %Vorgang.Vorgangsadresse
- %Vorgang.Ansprechpartner
- %Vorgang.Lieferadresse
- %Vorgang.Rechnungsadresse
- %Vorgang.Firmenstammadresse
Für Adressen gibt es sehr viele Platzhalter. Im Folgenden eine Auswahl, oft am Beispiel der Vorgangsadresse:
Platzhalter | Wert |
|---|---|
%Vorgang.Vorgangsadresse.AnzahlVorgaenge% | Anzahl der Vorgänge im System bei denen diese Adresse als Vorgangsadresse, Ansprechpartner, Lieferadresse oder Rechnungsadresse vorkommt. |
%Vorgang.Vorgangsadresse.AnzahlVorgaengeOhneGeloeschte% | Anzahl der nicht gelöschten Vorgänge im System bei denen diese Adresse als Vorgangsadresse, Ansprechpartner, Lieferadresse oder Rechnungsadresse vorkommt. |
%Vorgang.Vorgangsadresse.AnzahlVorgaengeDiesenTyps% | Anzahl der Vorgänge vom gleichen Vorgangstyp wie der aktuelle, bei denen diese Adresse als Vorgangsadresse, Ansprechpartner, Lieferadresse oder Rechnungsadresse vorkommt. |
%Vorgang.Vorgangsadresse.AnzahlVorgaengeDiesenTypsOhneGeloeschte% | Anzahl der nicht gelöschten Vorgänge vom gleichen Vorgangstyp wie der aktuelle, bei denen diese Adresse als Vorgangsadresse, Ansprechpartner, Lieferadresse oder Rechnungsadresse vorkommt. |
%Vorgang.Vorgangsadresse.AnzahlVorgaengeDieserAdresstypDiesenTyps% | Anzahl der Vorgänge vom gleichen Vorgangstyp wie der aktuelle, bei denen diese Adresse (Vorgangsadresse/Ansprechpartner/Lieferadresse/Rechnungsadresse) als ebenfalls als gleicher Adresstyp (Vorgangsadresse/Ansprechpartner/Lieferadresse/Rechnungsadresse) vorkommt. Beispiel: |
%Vorgang.Vorgangsadresse.AnzahlVorgaengeDieserAdresstypDiesenTypsOhneGeloeschte% | Anzahl der nicht gelöschten Vorgänge vom gleichen Vorgangstyp wie der aktuelle, bei denen diese Adresse als (Vorgangsadresse/Ansprechpartner/Lieferadresse/Rechnungsadresse) vorkommt. |
%Vorgang.Vorgangsadresse.Vorgangssprache.Bezeichnung% | Die Bezeichnung der Vorgangssprache der Adresse. |
%Vorgang.Vorgangsadresse.Benutzersprache.Bezeichnung% | Die Bezeichnung der Benutzersprache der Adresse. |
%Vorgang.Vorgangsadresse.StandardVerkaufsfaktor.Bezeichnung% | Die Bezeichnung / der Verkaufsfaktor des Standardverkaufsfaktors der Adresse. |
%Vorgang.Vorgangsadresse.StandardLieferartDebitor.Bezeichnung% | Die Bezeichnung der Standardversandart der Adresse (Kunde). |
%Vorgang.Vorgangsadresse.StandardLieferartKreditor.Bezeichnung% | Die Bezeichnung der Standardversandart der Adresse (Lieferant). |
%Vorgang.Vorgangsadresse.StandardLieferbedingungDebitor.Bezeichnung% | Die Bezeichnung der Standardversandbedingung der Adresse (Kunde). |
%Vorgang.Vorgangsadresse.StandardLieferbedingungKreditor.Bezeichnung% | Die Bezeichnung der Standardversandbedingung der Adresse (Lieferant). |
%Vorgang.Vorgangsadresse.StandardZahlungsartDebitor.Bezeichnung% | Die Bezeichnung der Standardzahlungsart der Adresse (Kunde). |
%Vorgang.Vorgangsadresse.StandardZahlungsartKreditor.Bezeichnung% | Die Bezeichnung der Standardzahlungsart der Adresse (Lieferant). |
%Vorgang.Vorgangsadresse.StandardZahlungsbedingungDebitor.Bezeichnung% | Die Bezeichnung / Reportbezeichnung / das Zahlungsziel [Tage] / Zahlungsziel für Skonto [Tage] / der Skonto [%] der Standardzahlungsbedingung der Adresse (Kunde). |
%Vorgang.Vorgangsadresse.StandardZahlungsbedingungKreditor.Bezeichnung% | Die Bezeichnung / Reportbezeichnung / das Zahlungsziel [Tage] / Zahlungsziel für Skonto [Tage] / der Skonto [%] der Standardzahlungbedingung der Adresse (Lieferant). |
u.v.m. RabattDebitor, RabattKreditor, KreditlimitDebitor, KreditlimitKreditor, Debitorennummer, Kreditorennummer, Kundennummer, ... | Sie können sich jede Eigenschaft einer Adresse ausgeben lassen. Aus Platzgründen wird auf eine vollständige Auflistung verzichtet. Die Autovervollständigung beim Skripten dürfte Ihnen in vielen Fällen weiterhelfen. Geben Sie nach dem Punk einfach einen Buchstaben ein, um eine Auswahl möglicher Werte zu erhalten. Treten Sie mit uns in Kontakt, wenn Sie eine Erweiterung der Dokumentation wünschen oder sonstige Fragen haben. |
Platzhalter für das aktuelle Datum
Mit einem Platzhalter namens "AKTDATUMFORM" können Sie das aktuelle Datum zum Zeitpunkt der Nummernkreiserstellung verwenden. Sie können das Datum mit bis zu zwei Parametern manipulieren, die mit einem Punkt abgetrennt werden. Das Formal lautet: %AKTDATUMFORM.Format.AddiereTage%
Format gibt an, wie die Ausgabe formatiert sein soll. Zum Beispiel "yyyy" für die Ausgabe des vierstelligen Jahres. AddiereTage kann eine beliebige Ganzzahl sein, die auf das aktuelle Datum (AKTDATUMFORM) addiert wird. Beispiele für die Verwendung finden Sie in der nachfolgenden Tabelle:
Platzhalter | Wert |
|---|---|
%AKTDATUMFORM% | Die letzten beiden Ziffern des Jahres zum Zeitpunkt der Nummernvergabe wird ausgegeben, z.B. 15. |
%AKTDATUMFORM.yy.360% | Wie %AKTDATUMFORM.yy%, es werden jedoch 360 Tage hinzuaddiert, z.B. 16. |
%AKTDATUMFORM.yyyy% | Vierstellige Jahresangabe, z.B. 2015. |
%AKTDATUMFORM.yyyy% | Vierstellige Jahresangabe, z.B. 2015. |
%AKTDATUMFORM.MM% | Ausgabe des Monats (zweistellig), z.B. 02. |
%AKTDATUMFORM.MMM% | Ausgabe des Monats (abgekürzt), z.B. Feb. |
%AKTDATUMFORM.MMM% | Ausgabe des Monats (ausgeschrieben), z.B. Februar. |
%AKTDATUMFORM.dd% | Ausgabe des Wochentages (zweistellig), z.B. 23. |
%AKTDATUMFORM.dd.2% | Ausgabe des Wochentages (zweistellig) von %AKTDATUMFORM.dd% plus zwei Tage, z.B. 25. |
%AKTDATUMFORM.ddd% | Ausgabe des Wochentages, z.B. Mo. |
%AKTDATUMFORM.dddd% | Ausgabe des Wochentages, z.B. Montag. |
%AKTDATUMFORM.HH% | Ausgabe der Stunde (24-Stunden-Format), z.B. 15. |
%AKTDATUMFORM.mm% | Ausgabe der Minute (zweistellig), z.B. 35. |
%AKTDATUMFORM.d% | Ausgabe des vollständigen Datums im Format: dd.mm.yyyy, z.B. 23.02.2015. |
Sie können natürlich ebenfalls auf die Angaben von Vorgangsinformationen zurückgreifen. Beachten Sie hierbei die verschiedenen Zeitpunkte der Festlegung der Werte. Beispielsweise exisitiert abhängig vom Abrufzeitpunkt nicht jeder Datumswert, wie zum Beispiel das Fertigstelldatum. Die Datumsinformationen des Vorgangs können Sie ebenfalls beliebig formatieren. Details und ein Beispiel finden Sie hier.
Platzhalter für den aktuellen Benutzer
Der Platzhalter für Daten des aktuellen Benutzers beginnt mit "%Benutzer." und endet mit einer auszugebenen Eigenschaft und "%".
Platzhalter | Wert |
|---|---|
%Benutzer.BevorzugterDrucker% | Gibt die ID des vom Benutzer bevorzugten Druckers aus. |
%Benutzer.Benutzersprache. ...% | |
%Benutzer.Vorgangssprache. ...% | |
%Benutzer.StandardVerkaufsfaktor. ...% | |
%Benutzer.StandardLieferartDebitor. ...% | |
%Benutzer.StandardLieferartKreditor. ...% | |
%Benutzer.StandardLieferbedingungDebitor. ...% | |
%Benutzer.StandardLieferbedingungKreditor. ...% | |
%Benutzer.StandardZahlungsartDebitor. ...% | |
%Benutzer.StandardZahlungsartKreditor. ...% | |
%Benutzer.StandardZahlungsbedingungDebitor. ...% | |
%Benutzer.StandardZahlungsbedingungKreditor. ...% | |
u.v.m. RabattDebitor, RabattKreditor, KreditlimitDebitor, KreditlimitKreditor, Debitorennummer, Kreditorennummer, Kundennummer, ... | Sie können sich jede Eigenschaft einer Adresse ausgeben lassen. Aus Platzgründen wird auf eine vollständige Auflistung verzichtet. Verwenden Sie die Autovervollständigung beim Skripten, um weitere verfügbare Eigenschaften zu nutzen. Geben Sie nach dem Punk einfach einen Buchstaben ein, um eine Auswahl möglicher Werte zu erhalten. |
Platzhalter für %
Wenn Sie in einem Skript ein Prozentzeichen ausgeben möchten, so verwenden Sie bitte den folgenden Platzhalter:
Platzhalter | Wert |
|---|---|
&Prozentzeichen& | % |
Scripting
Funktionen
Es können zum Beispiel beim Kopieren eines Vorgangs Funktionen mit Hilfe von Skripten ausgeführt und die verschiedenen Preismodule dynamisch angepasst werden.
Beim Kopieren eines alten Vorgangs werden dessen Daten im Regelfall übernommen, ohne dass diese mit den aktuellen Stammdaten aktualisiert werden. Das kann problematisch sein. Hat sich die Rechnungsadresse eines Kunden geändert oder ein Ansprechpartner, so müssen diese Daten manuell über die jeweiligen Webparts aktualisiert werden. Anstelle des manuellen Vorgehens durch einen Anwender, kann die Aktualisierung auch automatisch erfolgen. Dazu muss lediglich ein entsprechendes Skript beim jeweiligen Vorgangstyp hinterlegt werden. Es können für "Vorgang kopieren" und "Vorgang mit Stammbaum kopieren" verschiedene Skripte hinterlegt werden.
Jedes Preismodul von UniERM (z.B. Kundenfestpreise, Staffelpreise, Preislistenpreise, Einkaufspreise oder individuelle Kundenpreismodule) hat eine eigene Konfiguration (Rundungen, ob ein Rabatt greift, ...). Die Preismodule selber können in verschiedene Reihenfolgen für die Preisfindung eines Preissystems gebracht werden. Damit kann zum Beispiel festgelegt werden, ob der Kunde immer seinen Kundenfestpreis erhält oder nur wenn dieser günstiger ist, als der normale Preis. Mit Hilfe von Skripten kann das Preissystem noch flexibler gestaltet werden. Beispielsweise sind mit Hilfe von Bedingungen individuelle Preise in Abhängigkeit vom Vorgangstyp und der Adresse (z.B. Ansprechpartner) möglich.
- Vorgangsskripte (Vorgang (mit Stammbaum) kopieren) können im Webpart Konfiguration der Vorgangstypen festgelegt werden. Sie finden in der Dokumentation dieses Webparts eine Liste mit allen Möglichkeiten.
- Preismodulskripte können im Webpart Konfiguration Preissystem festgelegt werden. Sie finden in der Dokumentation dieses Webparts eine Liste mit allen Möglichkeiten.
Zuweisungsoperator
Funktionen wird ein Wahrheitswert (ja oder nein) zugewiesen, der explizit besagt, ob UniERM eine Funktion ausführen soll oder nicht. Dazu wird der {=}-Operator verwendet. UniERM führt standardmäßig alle Funktionen, die es zum Vorgang kopieren oder beim Preissystem gibt mit einem Standardwert (true oder false) aus. Mit Hilfe der Skripte kann dieser Standardwert geändert werden. Daher ist eine Wertzuweisung wichtig. Nur so kann sichergestellt werden, dass eine Funktion nicht ausgeführt wird.
Operator | Auswirkung |
|---|---|
{=} ja | Die Funktion, die vor dem Operator steht, wird ausgeführt. |
{=} nein | Die Funktion, die vor dem Operator steht, wird nicht ausgeführt. |
Suche
Sie können in Ihren Skripten nach verschiedenen Elementen (Sprachen, Länder, Währungen, Vorgangstypen, Verkaufsfaktoren...) suchen. Die Ausgabe kann u.a. bei Bedingungen verwendet werden. Zurückgegeben wird ein Objekt, auf dessen Eigenschaften mittels des Punktoperators (siehe oben) zugegriffen werden kann. Wird keine Eigenschaft für die Rückgabe spezifiziert, wird die ID des Objekts zurückgegeben.
Prefix | Suche |
|---|---|
%FindeSprache.!Suchbegriff!% | Suche nach einer Sprache anhand der Bezeichnung. |
%FindeWaehrungBezeichnung.!Suchbegriff!% | Suche nach einer Währung anhand der Bezeichnung. |
%FindeWaehrungISOCode.!Suchbegriff!% | Suche nach einer Währung anhand des ISO-Codes. |
%FindeVorgangsTyp.!Suchbegriff!% | Finde einen Vorgangstyp anhand der Bezeichnung. |
%FindeVerkaufsfaktor.!Suchbegriff!% | Suche nach einem Verkaufsfaktor anhand der Bezeichnung. |
%FindeLieferart.!Suchbegriff!% | Suche nach einer Versandart anhand der Bezeichnung in der Standardsprache. |
%FindeLieferbedingung.!Suchbegriff!% | Suche nach einer Versandbedingung anhand der Bezeichnung in der Standardsprache. |
%FindeZahlungsart.!Suchbegriff!% | Suche nach einer Zahlungsart anhand der Bezeichnung in der Standardsprache. |
%FindeZahlungsbedingung.!Suchbegriff!% | Suche nach einer Zahlungsbedingung anhand der Bezeichnung in der Standardsprache. |
%FindeLandBezeichnung.!Suchbegriff!% | Suche nach einem Land anhand der Bezeichnung. |
%FindeLandIsoCode.!Suchbegriff!% | Suche nach einem Land anhand des ISO-Codes. |
%FindeOrtPlzUndBezeichnung.!SuchbegriffPLZ!.!SuchbegriffBezeichnung!% | Suche nach einem Ort anhand der Postleitzahl und Bezeichnung. |
!Suchbegriff!
Ersetzen Sie den "!Suchbegriff!" Platzhalter durch Ihren Suchbegriff. Sie können ein "*" als Joker nutzen. Beispiele:
!Suchbegriff! | Suchergebnis |
|---|---|
Deut* | Findet z.B. "Deutsch". |
Deutsch | Findet z.B. "Deutsch". |
Deutsch* | Findet z.B. "Deutsch". |
Beispiele
Platzhalter | Wert |
|---|---|
%FindeSprache.Deutsch% | Gibt die ID der gefundenen Sprache zurück. Die Standardrückgabewert ist die ID. |
%FindeSprache.Deutsch.ID% | Gibt die ID der gefundenen Sprache zurück. |
%FindeSprache.Deut*.ID% | Gibt die ID der gefundenen Sprache zurück. |
%FindeSprache.De*.Bezeichnung% | Gibt die Bezeichnung der gefundenen Sprache zurück. |
%FindeOrtPlzUndBezeichnung.25335.E*.Bezeichnung% | Gibt die Bezeichnung des gefundenen Orts mit der Postleitzahl "25335" und den Anfangsbuchstaben "E" (Bezeichnung) zurück. |
Bedingte Anweisungen
Bedingte Anweisungen können mithilfe der Platzhalter {WENN} !Bedingung! {DANN} !Skript! {ENDE} realisiert werden. Bedingungen können mit dem {ODER}- und {UND}-Operator verknüpft werden: {WENN} (!Bedingung1! {ODER} !Bedingung2!) {UND} !Bedingung3! {DANN} !Skript! {ENDE}
Bedingte Anweisungen können* verschachtelt werden: {WENN} {DANN} {WENN} {DANN} {ENDE} {ENDE}
* Eine Verschachtelung ist nur bei Skripten möglich, die Text ausgeben, nicht bei Skripten, die Funktionen ausführen.
Operatoren
Die nachfolgenden Operatoren sind beim Formulieren von Bedingungen nutzbar:
Operator | Bedeutung |
|---|---|
x {=} y | Prüfung auf Gleichheit (wahr, wenn x gleich y). |
x {!=} y | Prüfung auf Ungleichheit (wahr, wenn x ungleich y). |
x {<} y | Kleiner als (wahr, wenn x kleiner als y ist). |
x {<=} y | Kleiner gleich (wahr, wenn x kleiner oder gleich y ist). |
x {>} y | Größer als (wahr, wenn x größer als y ist). |
x {<} y | Größer gleich (wahr, wenn x größer oder gleich y ist). |
!Bedingung1! {ODER} !Bedingung2! | Wahr, wenn Bedingung1 oder Bedingung2 erfüllt ist. |
!Bedingung1! {UND} !Bedingung2! | Wahr, wenn Bedingung1 und Bedingung2 erfüllt sind. |
Beispiele
Bedingung | Ergebnis |
|---|---|
{WENN} %Vorgang.Vorgangsadresse.AnzahlVorgaengeDieserAdresstypDiesenTyps% {>=} 10 {DANN} ... {ENDE} | Wenn es mehr als neun Vorgänge zur jeweiligen Vorgangsadresse gibt, dann wird das Skript zwischen "{DANN}" und "{ENDE}" ausgeführt. |
{WENN} %Vorgang.Vorgangsadresse.ID% {=} 5 {DANN} %Kopieren.AlleKundendatenAktualisierenUndNeuBeziehen% {=} ja {ENDE} | Beim Kopieren eines Vorgangs werden alle Kundendaten aktualisiert und neu aus den Stammdaten bezogen (somit werden ggf. nicht mehr aktuelle Informationen, die als Kopie am Vorgang selbst gespeichert sind, aktualisiert) mit Ausnahme der Ansprechpartnerdaten, sofern der zu kopierende Vorgang als Vorgangsadresse die mit der ID=5 hat. |
{WENN} %Vorgang.Vorgangstyp.Bezeichnung% {=} "Angebot" {UND} %Vorgang.Vorgangsadresse.Flag_IstHaendler% {=} ja {DANN} %Preissystem.KundenrabattGilt% {=} nein {ENDE} | Wenn es sich um ein Angebot handelt und die Vorgangsadresse die eines Händlers ist, dann nutzt das Preissystem keine Kundenrabatte. |
{WENN} %Vorgang.BruttoBerechnung% {=} ja {DANN} {WENN} %Vorgang.BruttoBerechnung% {=} nein {DANN} | In Anhängigkeit von der Berechnungsart (Brutto- oder Nettoberechnung) wird die Vorgangspositionsliste mit Artikelkurztext, Menge und Preisen ausgegeben, wobei die Preise entsprechend die Brutto- oder Nettopreise sind. |
