Vvidget Server ► Web Programming ► Direct URL
A normal or indirect Peer Visual Server URL (PVS-URL) directs a request to a web service on the HTTP port (port 80) and that gets redirected to a CGI-BIN and then to the Peer Visual Server. By contrast, the direct-PVS-URL accepts the PVS-URL directly from the requesting entity on the Peer Visual Server's private IP port.
To form the Peer Visual URL first see the specific URL type in any of the chapters in the dictionary section. For example, see the Pie Chart section to form the input string and append it to this following URL root:
http://localhost:9877/direct?pvs_version&contact&chart&output_type&width,height&
The following table defines the attribute fields shown in the URL above:
Field Name | Description |
localhost | The name of the computer that the request is directed to. Use localhost for requests on your computer, or use a valid computer name for requests to other computers (such as www.vvi.com). |
9877 | The PVS port number. By default, this is port 9877 or 9878, corresponding to channel 0 or 1 respectively. There are two separate Peer Visual Servers running on the computer and this port number indicates which one to use. |
direct | A string indicating that the request is direct. The Peer Visual Server processes this string and associates it with special internal processing appropriate to direct URL requests. |
For example, here is an actual Pie Chart direct-PVS-URL:
http://localhost:9877/direct?1&EMAIL&chart&2&200,200&chart_type=5&chart_subtype=0&chart_format_type=1&data_values=1%203%204%205%206&fill_color=AAAA00
If you click here then that string will be placed in the Address field of your web browser. Then you can modify it and click the Return key to see a new chart. You may want to copy the Peer-Visual chart URL shown above to a text editor first in order to modify it and then paste it into the Address field of your web browser.
When To Use The Direct-PVS-URL
There are 3 specific usages for the Direct-PVS-URL: