Sage: create routing text (CreateRoutingText)

A text can be assigned to a routing or a routing line item with this function. This text must have been created prior in the system (e.g. with CreateRichText). Multiple parameters can be filled with their corresponding values in the input parameter group. The following parameters in the parameter group can be filled: agaltern, agid, agpos, aplnr, lfdnr, txt_bst, txt_nr, typ. Meaning of the parameters:

typ	Type of connection	Describes what sort of text is present TP = pure text position KT = header text PT = position text
aplnr	Routing number	Must be entered with pure text positions and header texts.
agpos	Routing line item	Must be entered with pure text positions and header texts
agaltern	Position option	Must be entered with pure text positions and header texts
agid	Routing position ID	Must be entered with position texts
txt_nr txt_bst	Text number Text component	One of the two indicators must be entered

If the allocation cannot be created, the service delivers a corresponding error message. This is entered via the parameter Message. Before evaluating the output parameter group, the parameter Message should be verified.

The following parameters in the output parameter group are filled:

agaltern, agid, agpos, aplnr, lfdnr, txt_bst, txt_nr, typ.

Syntax:	Status = f$SageService ( Service , 'CreateRoutingText', 'PGINPUT' , 'PGOUTPUT' )
	Argument	Type	Meaning
	Service	String	URL of the web service
	'CreateRoutingText'	String	Command constant
	'PGINPUT'	String	Name of the ePOS parameter group with the data for the text line to be created.
	'PGOUTPUT'	String	Name of the ePOS parameter group with the result data.
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' arpl_such.aplidentnr = 'BNUESSLE-T02' arpl_such.art = 1 Status = f$SageService ( B7Service , 'ReadRouting' , 'arpl_such' , 'arpl_kopf,arpl_pos' ) rich_text.txtrich = 'Description of first routing line item' rich_text.lang_ext = 'en_us' rich_text.txt_art = 'TTI' Status = f$SageService ( B7Service , 'CreateRichText' , 'rich_text' , 'rich_text' ) arpl_text.typ = 'PT' arpl_text.aplnr = arpl_pos[1].aplnr arpl_text.agpos = arpl_pos[1].agpos arpl_text.agaltern = arpl_pos[1].agaltern arpl_text.agid = arpl_pos[1].agid arpl_text.txt_nr = rich_text.txt_nr Status = f$SageService ( B7Service , 'CreateRoutingText' , 'arpl_text' , 'arpl_text' )