Table Of Contents

Graph IDENetwork Clients ► Web Adapter

This section describes how Graph IDE results can be vended to the Internet. It might not dawn on you at first but because Graph IDE documents are Programmable that means that when they are opened a program is executed. The Web Adapter works with the built-in Server to respond to a web browser by opening up a document, executing it and then translating that result to an image that the web browser can use. Thus without any additional effort, beyond correctly setting up a web server, Graph IDE can be used to vend dynamic, programable and real-time results to the Internet.

The following lists some resources available for the web adapter. You may wish to skip the following table on first pass.

LinkDescription Of Resource
nph-pvs.zip/td>The compressed nph-pvs CGI located on your disk within this manual.
nph-pvs.zip/td>The compressed nph-pvs CGI located at the vvidget.org web site.
Vvidget™ Server Reference Manual/td>The Vvidget™ Server Reference Manual describes how to format query strings for input into the server.†
vvidget.org/td>The vvidget.org internet server is the same one incorporated into Graph IDE and you can use that site to vend results as well.†
OS X Server/td>The OS X Server application on the Mac App Store. That contains a web server that may be appropriate for your use.†

The following assumes that you have the Apache web server running on the computer that is licensed for Graph IDE, the Graph IDE Server is set to on, Graph IDE is auto launched at login and your computer is set to login the user when it boots.

Download nph-pvs.zip (using the links shown above), uncompress the download by double clicking it and then drag the result to the CGI-BIN folder of your web server. That folder may be /Library/WebServer/CGI-Executables depending upon your configuration.

If you configured the web server correctly and are viewing this manual on the computer running that web server then the following image should show a line graph.

Which is the imaged results of the following URL:

<img src="http://localhost/cgi-bin/nph-pvs?
1&EMAIL&chart&1&400,300&chart_type=1&chart_subtype=0&chart_format_type=1
&title=My%20Title&x_title=My%20X%20Title&y_title=My%20Y%20Title
&data_1=1%2020.0%202%2040.0%203%2035.4%204%2066.2%205%2077.3
&data_2=1%2030.0%202%2099.0%203%2010.0%204%2060.0
&data_3=1%20123.0%202%2034.0%203%2099.0%204%2077.3
&line_color=000000" width=400 height=300 border=0>

The above image was generated on the fly without any additional Graph IDE document. If you make your own Graph IDE document and save it in your web server's document path (for example: /Library/WebServer/Documents) then it too can be imaged. For example, if you make a Graph IDE document named GnomeStudy with Graphic View width 400 and height 300 and save that document in the web server's document path then its display is accessible to anyone on the Internet using a URL like this:

<img src="http://www.mydomain.com/cgi-bin/nph-pvs?1&direct&document&2&400,300&GnomeStudy&quot;>

where "mydomain.com" is the domain of your own server.

Notice that the Mac App Store Edition of Graph IDE is sandboxed so can only open documents for which it has permission. The Manufacturer Edition is not sandbox and can open documents in the web server documents directory. Because of the very large matrix of deployment conditions it is impossible to itemize all of the deployment issues within the limited scope of this manual. If you are using a sandboxed version then it might be possible to create a link from the web server document folder and the Server Document's access point (see Server) and store documents at that access folder so that the web adapter can image them. On the other hand, depending on the version of OS X you are using and the security settings that might not be possible. As usual, there are many site-specific caveats and security issues.

The server (also part of Peer Visual Server† and Vvidget Server†) is based on an enterprise class SOA server which can be configured and scaled to server farm multi-homed, multi-process, distributed, multi-threaded, multi-client asynchronous, state and stateless use, fallback and autorestart configurations, i.e.: the full works. The configuration built into Graph IDE can power a substantial web site service as well as be used for scripting purposes. The extensive options, configurations, use and reliability are beyond the scope of this manual. This manual is simply concerned with turning the server on and demonstrating its use. Other referenced manuals are more comprehensive.


† Sold and licensed separately.




© Copyright 1993-2019 by VVimaging, Inc. (VVI); All Rights Reserved. Please email support@vvi.com with any comments you have concerning this documentation. See Legal for trademark and legal information.