RPC HELP Tutorial Step 10 - Revision history

Kdtop at 21:35, 16 July 2015

2015-07-16T21:35:44Z

← Older revision		Revision as of 21:35, 16 July 2015
Line 11:		Line 11:
	{\| class="grey" border="1" cellpadding="2"		{\| class="grey" border="1" cellpadding="2"
	\|-		\|-
	~~! Terminal Type Field~~
	! Add a TEdit component named		! Add a TEdit component named
	! Add a Label with the Caption:		! Add a Label with the Caption:
			! Terminal Type Field
	\|-		\|-
	~~\| .01~~
	\| Name		\| Name
	\| Name		\| Name
			\| .01
	\|-		\|-
	~~\| 1~~
	\| RightMargin		\| RightMargin
	\| Right Margin:		\| Right Margin:
			\| 1
	\|-		\|-
	~~\| 2~~
	\| FormFeed		\| FormFeed
	\| Form Feed:		\| Form Feed:
			\| 2
	\|-		\|-
	~~\| 3~~
	\| PageLength		\| PageLength
	\| Page Length:		\| Page Length:
			\| 3
	\|-		\|-
	~~\| 4~~
	\| BackSpace		\| BackSpace
	\| Back Space:		\| Back Space:
			\| 4
	\|-		\|-
	~~\| 6~~
	\| OpenExecute		\| OpenExecute
	\| Open Execute:		\| Open Execute:
			\| 6
	\|-		\|-
	~~\| 7~~
	\| CloseExecute		\| CloseExecute
	\| Close Execute:		\| Close Execute:
			\| 7
	\|}		\|}

Kdtop at 21:20, 16 July 2015

2015-07-16T21:20:04Z

← Older revision		Revision as of 21:20, 16 July 2015
Line 43:		Line 43:
	\| Close Execute:		\| Close Execute:
	\|}		\|}

			When done, the form should look like this:

			[[Image:RPC_HELP_Tutorial_Step_10A.png]]

	'''2.''' Update ListBox1's OnClick event handler. Add code so that when the user clicks on an entry in the list box, your application will call the ZxxxTT RETRIEVE [[RPC_HELP_RPCs\|RPC]] to retrieve fields for the corresponding terminal type, and display those fields in the set of TEdit controls on your form. This code should:		'''2.''' Update ListBox1's OnClick event handler. Add code so that when the user clicks on an entry in the list box, your application will call the ZxxxTT RETRIEVE [[RPC_HELP_RPCs\|RPC]] to retrieve fields for the corresponding terminal type, and display those fields in the set of TEdit controls on your form. This code should:

Kdtop at 18:05, 15 July 2015

2015-07-15T18:05:39Z

← Older revision		Revision as of 18:05, 15 July 2015
Line 80:		Line 80:

	'''3.''' Compile and run your application. When you click on an entry in the list box now, the corresponding fields should be retrieved and displayed in the set of edit boxes on your form.		'''3.''' Compile and run your application. When you click on an entry in the list box now, the corresponding fields should be retrieved and displayed in the set of edit boxes on your form.

			[[Image:RPC_HELP_Tutorial_Step_10.png]]

	<h4>[[RPC_HELP_Tutorial_Step_9\|PREV: Step 9: RPC To Retrieve Terminal Types]]</h4>		<h4>[[RPC_HELP_Tutorial_Step_9\|PREV: Step 9: RPC To Retrieve Terminal Types]]</h4>
	<h4>[[RPC_HELP_Tutorial_Step_11\|NEXT: Step 11: Register RPCs]]</h4>		<h4>[[RPC_HELP_Tutorial_Step_11\|NEXT: Step 11: Register RPCs]]</h4>

Kdtop at 20:42, 5 July 2015

2015-07-05T20:42:16Z

← Older revision		Revision as of 20:42, 5 July 2015
Line 1:		Line 1:
			[[RPC_Broker_Help\| RPC Broker Help Home]]

			[[RPC_Broker_Help#Tutorial\|Tutorial Home]]
	<h2>Tutorial: Step 10 -- Call Zxxx RETRIEVE RPC</h2>		<h2>Tutorial: Step 10 -- Call Zxxx RETRIEVE RPC</h2>
	When a user selects a terminal type entry in the list box, the OnClick event is triggered. The new ZxxxTT RETRIEVE [[RPC_HELP_RPCs\|RPC]] can be called from that OnClick event, as a replacement for the code there that simply displays the IEN of any selected record.		When a user selects a terminal type entry in the list box, the OnClick event is triggered. The new ZxxxTT RETRIEVE [[RPC_HELP_RPCs\|RPC]] can be called from that OnClick event, as a replacement for the code there that simply displays the IEN of any selected record.

Kdtop: Created page with "

Tutorial: Step 10 -- Call Zxxx RETRIEVE RPC

When a user selects a terminal type entry in the list box, the OnClick event is triggered. The new ZxxxTT RETRIEVE [[RPC_H..."

2015-07-05T20:20:43Z

Created page with "<h2>Tutorial: Step 10 -- Call Zxxx RETRIEVE RPC</h2> When a user selects a terminal type entry in the list box, the OnClick event is triggered. The new ZxxxTT RETRIEVE [[RPC_H..."

New page

<h2>Tutorial: Step 10 -- Call Zxxx RETRIEVE RPC</h2>
When a user selects a terminal type entry in the list box, the OnClick event is triggered. The new ZxxxTT RETRIEVE [[RPC_HELP_RPCs|RPC]] can be called from that OnClick event, as a replacement for the code there that simply displays the IEN of any selected record.

To use the ZxxxTT RETRIEVE [[RPC_HELP_RPCs|RPC]] to display fields from a selected terminal type:

'''1.''' Create labels and edit boxes for each of the fields the RPC returns from the Terminal type file:

{| class="grey" border="1" cellpadding="2"
|-
! Terminal Type Field
! Add a TEdit component named
! Add a Label with the Caption:
|-
| .01
| Name
| Name
|-
| 1
| RightMargin
| Right Margin:
|-
| 2
| FormFeed
| Form Feed:
|-
| 3
| PageLength
| Page Length:
|-
| 4
| BackSpace
| Back Space:
|-
| 6
| OpenExecute
| Open Execute:
|-
| 7
| CloseExecute
| Close Execute:
|}

'''2.''' Update ListBox1's OnClick event handler. Add code so that when the user clicks on an entry in the list box, your application will call the ZxxxTT RETRIEVE [[RPC_HELP_RPCs|RPC]] to retrieve fields for the corresponding terminal type, and display those fields in the set of TEdit controls on your form. This code should:
* Set RCPBroker1's [[RPC_HELP_TRPCBroker_RemoteProcedure|RemoteProcedure]] property to ZxxxTT RETRIEVE.
* Pass the IEN of the selected terminal type to the [[RPC_HELP_RPCs|RPC]], using the [[RPC_HELP_TRPCBroker|TRPCBroker]]'s runtime Param property. Pass the IEN in the [[RPC_HELP_TParamRecord_Value_Property|Value]] property (i.e., brkrRPCBroker1.Param[0].Value).
* The [[RPC_HELP_TParamRecord_PType_Property|PType]] for the IEN parameter should be passed in brkrRPCBroker1.Param[0].PType. Possible types are '''literal''', '''reference''' and '''list'''. In this case, to pass in an IEN, the appropriate [[RPC_HELP_TParamRecord_PType_Property|PType]] is '''literal'''.
* Call brkrRPCBroker1's [[RPC_HELP_TRPCBroker_Call_Method|Call]] method (in a '''try...except''' exception handler block) to invoke the ZxxxTT RETRIEVE [[RPC_HELP_RPCs|RPC]].
* Set the appropriate pieces from each of the three [[RPC_HELP_TRPCBroker_Results|Results]] nodes into each of the TEdit boxes corresponding to each returned field.
* The code for the OnClick event handler should look like the following:

'''procedure''' TForm1.ListBox1Click(Sender: TObject);
'''var'''
ien: String;
'''begin'''
'''if''' (ListBox1.ItemIndex <> -1) '''then begin''' {displayitem begin}
ien:=piece(TermTypeList[ListBox1.ItemIndex],'^',1);
brkrRPCBroker1.RemoteProcedure:='ZxxxTT RETRIEVE';
brkrRPCBroker1.Param[0].Value := ien;
brkrRPCBroker1.Param[0].PType := literal;
'''try'''
'''begin''' {call code begin}
brkrRPCBroker1.Call;
Name.Text:=piece(brkrRPCBroker1.Results[0],'^',1);
RightMargin.Text:=piece(brkrRPCBroker1.Results[0],'^',2);
FormFeed.Text:=piece(brkrRPCBroker1.Results[0],'^',3);
PageLength.Text:=piece(brkrRPCBroker1.Results[0],'^',4);
BackSpace.Text:=piece(brkrRPCBroker1.Results[0],'^',5);
OpenExecute.Text:=brkrRPCBroker1.Results[1];
CloseExecute.Text:=brkrRPCBroker1.Results[2];
'''end;''' {call code end}
'''except'''
'''On''' EBrokerError '''do'''
ShowMessage('A problem was encountered communicating with the server.');
'''end;''' {try end}
'''end;''' {displayitem end}
'''end;'''

'''3.''' Compile and run your application. When you click on an entry in the list box now, the corresponding fields should be retrieved and displayed in the set of edit boxes on your form.

<h4>[[RPC_HELP_Tutorial_Step_9|PREV: Step 9: RPC To Retrieve Terminal Types]]</h4>
<h4>[[RPC_HELP_Tutorial_Step_11|NEXT: Step 11: Register RPCs]]</h4>