Sage: Artikel und Varianten lesen (ReadArticle)

Lesen der Daten eines Artikels. In der Eingabeparametergruppe muss der Parameter identnr mit einer gültigen Identnummer belegt werden. Außerdem kann der Parameter var mit der gesuchten Variante belegt werden. Durch Belegen des Parameters lang_ext kann gesteuert werden, welche Sprache gelesen werden soll. Die Suche sollte genau einen Datensatz ergeben. Ansonsten liefert der Service eine entsprechende Fehlermeldung. Diese wird über den Parameter Meldung übergeben. Vor einer Auswertung der Ausgabeparametergruppe sollte der Parameter Meldung überprüft werden.

Bei einem Variantenartikel können mit dieser Funktion auch die Merkmale gelesene werden. Wenn als PGOUTPUTListe zwei mit Komma getrennte Parametergruppennamen angegeben werden, wird die erste Parametergruppe mit den Daten des Artikels gefüllt und die zweite Parametergruppe mit den Merkmalen. Diese Parametergruppe muss indiziert sein. Die Größe wird bei Bedarf angepasst. Die Parametergruppe sollte vom Typ tdv:sage_variantenmerkmale sein. Siehe auch Sage: Artikel Merkmale lesen (ReadArticleCriterion) und Sage: Artikelmerkmale auslesen

Folgende Parameter der Parametergruppe des Artikels werden gefüllt.:

abmessung, aendnr, agr, altern, aplidentnr, aplvar, ben, ben1, bestell, bild, bild_inet, bonuskz, breite, bs, cadkz, cadnr, ch, dataen, datneu, doku, dpreis, ekpreism, epreis, gewicht, hoehe, identnr, kalkpreis, klasse, kn_sebl, kn_variant, kn_vsperre, kontovb, kontovr, kontowe, kontowv, kostst, kurz_ben, laenge, lang_ext, lgnr, mc_var, me, me_abmessung, mep, mev, mevk, norm, normnr, objektid, orpreis, pe, peek, pevk, preisgrp, prodgr, rabattkz, staffel, stlidentnr, stlvar, ts_m, ts_w, txt_nr, umrech, umrechp, umrechvk, updatenr, useraen, userneu, var, var_akt, volumen, vpreis, werkstoff, wgr, zeichnr.

Folgende Parameter der Parametergruppe der Merkmale werden gefüllt.:

ausprid, ausprint, ausprfloat, ausprtxt, kritgrp, kritnr, kzdruck, lfdnr, objektid, objektid_g710, objektid_k, wertberid..

Die gelesenen Merkmale können mit der Funktion p$tdv:sage:merkmale_lesen in die Parametergruppe der Merkmale des Anwenderregelwerks kopiert werden.

Syntax:	Status = f$SageService ( Service , 'ReadArticle' , 'PGINPUT' , 'PGOUTPUTListe' )
	Argument	Typ	Bedeutung
	Service	Zeichenkette	URL des WebService Dienstes
	'ReadArticle'	Zeichenkette	Befehlskonstante
	'PGINPUT'	Zeichenkette	Name der ePOS Parametergruppe mit den Suchkriterien. Ausgewertet werden in dieser Funktion nur die Parameter identnr und var. Diese müssen den zu lesenden Artikel identifizieren.
	'PGOUTPUTListe'	Zeichenkette	Name der ePOS Parametergruppen mit den Ergebnisdaten zum Artikel und ggf. den Merkmalen
Ergebnis:	Ganzzahl	Status der Funktion: 1 : die Servicefunktion wurde erfolgreich aufgerufen -1 : die Komponente eposvbcomexe konnte nicht gefunden werden -2 : keine URL der Funktion angegeben -4 : allgemeiner Fehler
Beispiel:	B7Service = 'http://b7demo.sagebaeurer.de/br71/callin/epos_soap' art_such.identnr = '9-100' art_such.var = '0001' Status = f$SageService ( B7Service , 'ReadArticle' , 'art_such' , 'art_erg' ) p$anzeige_ergebnis('art_erg' )

Die ET: anzeige_ergebnis (Der Name der Parametergruppe wird übergeben)

Meldung	’’

p$TDV:Param:PGAnzeige( 0, pg )	X
f$Meldung (’Sage Meldung’, Meldung)		X