Sage: read articles and variants (ReadArticle)

Read the data for an article. In the input parameter group, the parameter identnr must be filled with a valid identification number. Furthermore, the parameter var can be occupied with the variant searched for. By filling the parameter lang_ext, you can control which language is to be read. The search should result in exactly one data record. Otherwise the service returns a corresponding error message. This is entered via the parameter Message. Before evaluating the output parameter group, the parameter Message should be verified.

If a variant article, criteria can also be read with this function. If two parameter group names separated by a comma are entered as the PGOUTPUTlist, the first parameter group is filled with the data for the article and the second parameter with the criteria. This parameter group must be indexed. The size is adjusted if necessary. The parameter group should be of the type tdv:sage_variantenmerkmale.

The following parameters of the article’s parameter group are filled:

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.

The following parameters from the criteria’s parameter group are filled:

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

The criteria read can be copied to the criteria’s parameter group in the user’s set of rules with the function p$tdv:sage:merkmale_lesen.

Syntax:	Status = f$SageService ( Service , 'ReadArticle' , 'PGINPUT' , 'PGOUTPUTList' )
	Argument	Type	Meaning
	Service	String	URL of the web service
	'ReadArticle'	String	Command constant
	'PGINPUT'	String	Name of the ePOS parameter group with the search criteria. Only the parameters identnr and var are evaluated in this function. They must identify the article to be read.
	'PGOUTPUTList'	String	Name of the ePOS parameter groups with the result data for the article and, if applicable, the criteria
Result:	Integer	Status of the function: 1 : the service function was successfully called -1 : the component eposvbcomexe could not be found -2 : function URL not entered -4 : general error
Example:	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' )

The DT: anzeige_ergebnis (the name of the parameter group is entered)

Message	’’

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