Assigning firewall settings to access a Web service

When you add a Web service at design time and your development machine is behind a firewall, you must assign proxy server settings to connect to the Internet.

Table 29-1 displays the design-time proxy server settings that you can enter on the Firewall Settings page of the PowerBuilder System Options dialog box. To enter runtime proxy server settings, you must use the SoapConnection SetProxyServer or the SetProxyServerOptions methods.

For information about the SetProxyServer or the SetProxyServerOptions methods, see the PowerBuilder Extension Reference in the online Help.

**Table 29-1: Design-time firewall settings**
Firewall setting	Description
Proxy host	Name of the proxy server that you use to access Web pages
Port	The port used for connecting to the proxy server
User name	User name for accessing the proxy server
Password	Password for the user accessing the proxy server

PowerBuilder uses the values you enter for the proxy server settings only if you also select the Use Above Values as System Defaults check box on the Firewall Setting page. The type of engine you select for consuming a Web service can also affect the settings that PowerBuilder uses to connect to the Internet at design time.

.NET Web service engine If the development machine is located behind a firewall but you do not select the Use Above Values as System Defaults check box, PowerBuilder attempts to connect to the Internet using settings entered in the Internet Options dialog box of the Internet Explorer browser. The selections you make on the Firewall Setting page have no effect if the development machine is not located behind a firewall.

EasySoap Web service engine If you do not select the Use Above Values as System Defaults check box, PowerBuilder assumes that the development machine is not behind a firewall and makes no attempt to use settings from the Internet Options dialog box of the Internet Explorer browser. If you select the Use Above Values as System Defaults check box, but the development machine is not located behind a firewall, the Web service invocation can fail.