p$TDV:SMPAPI:S_MrkMal

Schreiben bzw. Ändern der Merkmale (freie Parameter) Die Objektart (z.B. „Angebot") wird im Parameter ObjektArt in Form eines Buchstabencodes übergeben. Das Objekt selbst wird über die Identifikationsnummer dieses Objektes (z.B. ist dies die KontaktID bei einem Angebot) bestimmt.

Mit dieser Funktion kann eine einzelne Merkmals-Parametergruppe geschrieben werden. Dann wird im Parameter MerkmalPG der Name dieser PG als Text übergeben. Weicht der Name der PG der zu speichernden Parameter in der Datenbank von dem PG-Namen in der Logik ab, so können die Parameter zum Schreiben auch „umbenannt" werden. Dies wird bei der Übergabe des Parameters MerkmalPG wie folgt festgelegt:

’{<PGName in der Datenbank>}<PGName in der Logik>’

d.h. der PG-Name für die Datenbank wird in geschweifte Klammern eingeschlossen (siehe Beispiel). Diese Technik kann z.B. dann sinnvoll sein, wenn Daten verschiedener Artikelgruppen in individuellen Parametergruppen gespeichert werden, aber dennoch allgemeine Merkmale gleichen Parameternamens existieren, die gemeinsam verarbeitet werden können.

Ebenso können auch mehrere Parametergruppen gleichzeitig geschrieben werden. Dann muss im Parameter MerkmalPG ein Name eines globalen Feld-Parameters übergeben werden, der dann wiederum die Namen der Merkmals-Parametergruppen enthält (siehe Beispiel). Den Abschluss dieser Liste bildet ein Feldelement im Zustand LEER. Ein Umbenennen der Merkmals-PG-Namen ist hier ebenfalls möglich.

Ein Parameter im Zustand UNDEF bewirkt ein Löschen des Merkmals in der Datenbank. Siehe auch den Datenaustausch mit SalesManager NG über Parametergruppen.

Bitte beachten: Die Parametergruppe bzw. das PG-Feld, die in MerkmalPG übergeben werden, werden jeweils indirekt in einer Zeichenkette übergeben, also in Anführungszeichen eingeschlossen. Außerdem müssen das Feld bzw. die Merkmals-Parametergruppen global sein!

Syntax:	Status = p$TDV:SMPAPI:S_MrkMal( MerkmalPG, ObjektID, ObjektArt )
	Argument	Typ	Bedeutung
	MerkmalPG	Zeichenkette	a) Name der zu schreibenden Parametergruppe mit den Merkmalswerten b) Name der Merkmals-PG in der Datenbank (eingeschlossen in geschweifte Klammern), gefolgt vom Namen der Merkmals-PG in der Logik (ohne Leerzeichen). Beispiel: '{Motor}Konfig' c) Name eines Feldes mit den Namen der zu lesenden Parametergruppen (das Listenende ist durch einen Eintrag mit LEER hinter der letzten PG gekennzeichnet)
	ObjektID	Zeichenkette	Identifikation des Objektes gemäß dem in ObjektArt übergebenen Code
	ObjektArt	Zeichenkette	Bestimmung des SalesManager NG-Objektes gemäß: 'A': Anschrift, ObjektID ist AnschriftID aus V_Anschrift 'C': Produktkatalog, ObjektID ist MaterialID aus V_Produkt 'F': Angebot, ObjektID ist KontaktID aus V_Kontakt 'K': Auftrag, ObjektID ist AuftragID aus V_Auftrag 'M': Warenkorbposition, ObjektID ist MaterialID aus V_Warenpos 'P': Person, ObjektID ist PersonID aus V_Person
Ergebnis:	Ganzzahl		Status der Operation 0: Daten erfolgreich geschrieben <0: Fehler gemäß ePOS-Fehler-Liste >0: Fehler gemäß SMP-Fehlerstatus-Liste Der Rückgabestatus in SalesManager NG-Funktionen
Beispiel:	Schreiben der Merkmals-Parametergruppe „Konditionen" einer Warenkorb-Position mit der MaterialID "4711": Status = p$TDV:SMPAPI:S_MrkMal( 'Konditionen', '4711', 'M' ) Dieser Aufruf istfunktional identisch zu: Status = p$TDV:SMPAPI:S_MrkPos( 'Konditionen', '4711' ) Da die Funktion mit einer identischen Übergabe der Merkmals-Parametergruppen arbeitet, können die dortigen Beispiele auf diese Funktion übertragen werden.

Verwandte Funktion: p$TDV:SMPAPI:L_MrkMal