p$TDV:SMPAPI:WkTx_LTX
p$TDV:SMPAPI:WkTx_LTX
Lesen von Daten zu den Positionstexten einer Warenkorbposition oder eines Artikels aus dem Produktkatalog.
Die zu lesenden Daten werden bestimmt über
·die ObjektArt, d.h. den Buchstaben „C" für den Produktkatalog, bzw. den Buchstaben „M" für eine Warenkorbposition
·die ObjektID, d.h. die Identifikationsnummer gemäß der ObjektArt:
·„C": die ObjektID ist die MaterialID aus der Tabelle TM_Produkt
·„M": die ObjektID ist die MaterialID aus der Tabelle TM_Warenpos. In der PG der Warenkorbpositionsdaten (siehe PG SMWkPos) steht diese Zahl im Parameter MaterialIdent.
·den SprachCode, d.h. einen Zahlencode für die zu lesende Zielsprache. Dieser Zahlencode kann der Tabelle TP_Sprache entnommen werden. Diese Tabelle kann für jede Installation frei konfiguriert werden.
Die gelesenen Informationen werden in eine Parametergruppe geschrieben, die dieser Funktion ebenfalls übergeben wird. Diese Parametergruppe kann frei benannt werden, die vollständige Liste der möglichen Parameter findet sich in der Beschreibung zur Parametergruppe PosText.
Syntax: | Status = p$TDV:SMPAPI:WkTx_LPA( Modus, ObjektID, AnschriftArt, PG ) | ||
| Argument | Typ | Bedeutung |
| Modus | Ganzzahl | Schalter für Kontakt / Auftrag: |
| ObjektID | Zeichenkette | Identifikationsnummer des Salesmanager-Objekts abhängig von Modus: |
| AnschriftArt | Zeichenkette | die gesuchte Art der Anschrift (Feld AnschriftArt aus Abfrage A_Projektadressen) |
| PG | Zeichenkette | Name einer Parametergruppe mit beliebigen Feldern aus der Abfrage A_Projektadressen. Nach erfolgreichem Lesen der Adresse wird diese PG mit den Daten gefüllt; ansonsten wird der Inhalt auf LEER gesetzt. |
Ergebnis: | Ganzzahl | 0: die gesuchte Adresse wurde gelesen | |
Beispiel: | Lesen der Lieferanschrift zum Auftrag mit der AuftragID 4711. Die Daten sollen in einer PG namens adr zur Verfügung gestellt werden: Status = p$TDV:SMPAPI:WkTx_LPA( 2, '4711', 'Lieferanschrift', 'adr' ) | ||
Beispiel: Auswertung eines Positionstextes einer Warenkorbposition
Die Positionsdaten seien in der Parametergruppe pos[i] gespeichert und es soll die Sprache mit dem Sprachcode 2 verwendet werden.
Wenn ein Positionstext hinterlegt ist, soll die Bezeichnung als Benennungstext der Position ausgegeben werden. Wenn nicht, soll die Benennung der Warenkorbposition verwendet werden. Im Textbaustein wurde dazu ein spezieller Bausteinparameter "Bez" definiert.
Wenn ein RTF-Text vorhanden ist, soll dieser an das Textdokument angefügt werden.
ET "PosText":
|
| R 01 | SONST |
B 01 |
|
|
|
A 01 | St = p$TDV:SMPAPI:WkTx_LTX pos[i].MaterialIdent, ’M’, ’2’, ’pt’ ) | x |
|
A 02 | p$PosText2() | x |
|
ET "PosText2":
|
| R 01 | R 02 | SONST |
B 01 | St | 0 | 0 |
|
B 02 | pt.MemoText | ’MemoText’ |
|
|
B 03 |
|
|
|
|
A 01 | p$TDV:SMPAPI:EtTxPar( ’Bez’, pt.Bezeichnung ) | x | x |
|
A 02 | p$TDV:SMPAPI:EtTxPar(’Bez’, pos[i].Benennung) |
|
| x |
A 03 | p$TDV:SMPAPI:EtTxRTF( pt.TextID, ’TextID’, ’TM_Texte’, ’MemoText, ’’ ) | x |
|
|
Anmerkungen zur ET PosText2:
·Regel 1 trifft zu, wenn Positionstextdaten vorhanden sind (St=0) und in diesen Daten ein Memotext eingegeben wurde.
·Regel 2 trifft zu, wenn ein Positionstext ohne Memotext vorhanden ist.