Ein Beispiel

Im Folgenden soll ein kurzes Beispiel für die Anwendung dieser Schnittstelle aufgezeigt werden.

Initialisierung der Schnittstelle für ein Warenkorb-Dokument:

p$TDV:SMPAPI:WkTx_Ini( 'wkkopf', 'wkpos', ID )

Initialisierung der Textgenerierung mit der Festlegung des Ausgabedokumentes:

p$TDV:SMPAPI:EtTxInit( 'c:\\Angebote', '', wkkopf.Titel, 0 )

Öffnen des ersten Textbausteins, von dem auch die Informationen der Dokumentvorlage verwendet werden sollen:

p$TDV:SMPAPI:EtTxBast( 1, 'AngKopf' )

Bewerten von zusätzlichen Felder vom Typ Dokvariablen für den Angebotskopf, die nicht automatisch über die Bewertung der Parametergruppen-Parameter belegt werden (falls erforderlich):

p$TDV:SMPAPI:EtTxTxPar( 'Zusatz-Text', 'Eilt!!' )

Aktualisieren der Felder vom Typ Dokvariable im ersten Textbaustein (inclusive aller Felder vom Typ Dokvariable aus Parametergruppen, die zu diesem Zeitpunkt aus der Logik abgefragt werden):

p$TDV:SMPAPI:EtTxAktV()

Die Bearbeitung des ersten Textbausteins ist damit abgeschlossen. Nun können in einer Schleife die weiteren Textbausteine abgearbeitet werden, wobei spezielle Parameterbewertungen vor dem Einkopieren des zugehörigen Textbausteins erfolgen müssen.

Umkopieren der Parameter aus dem indizierten Feld der Warenkorbpositionen auf eine nicht indizierte Parametergruppe, die im Textbaustein verwendet wird (damit kann derselbe Textbaustein unabhängig von der Anordnung im Warenkorb verwendet werden):

f$PGKopie( 'wkpos[1]', 'wk' )

In einer Schleife über die Warenkorbpositionen kann der o.a. feste Index 1 auch durch den Schleifenzähler ersetzt werden, z.B. 'wkpos[i]'

Einfügen des Textbausteins für diese Position und Aktualisieren aller Felder vom Typ Dokvariable:

p$TDV:SMPAPI:EtTxBast( 1, 'AngPos' )

Nachdem auf diese Weise alle relevanten Warenkorbpositionen abgearbeitet worden sind und auch ggf. noch ein Angebotsfuß-Baustein ergänzt wurde, kann das Textdokument abgeschlossen werden:

p$TDV:SMPAPI:EtTxExit( )