|
PopChart Embedder API | PopChart Server Reference 4.0.5 |
Syntax myPopChart.saveImageToPopChartServer(name)
JavaBean Syntax <JSP:setProperty name="myPopChart" property="saveImageToPopChartServer" value="name" />
Description Saves the generated PopChart image to the specified location on PopChart Server.
Important: A password is required (using the password attribute) to save images. Also, you must have permission to save the file to the location that you save it to (see "Setting Path Permissions" in Chapter 3 of the PopChart Server User Guide.).
Saving the image to PopChart Server allows you to load it later using the loadServerSideImage(String) method. Under certain circumstances, this strategy can increase your server's capacity. For example, if you know that a particular PopChart image will be viewed often, you can save it to PopChart Server the first time that someone requests it, and then use the loadServerSideImage(String) to load it each subsequent time that someone requests it. The result is that PopChart Server generates only one image, no matter how often it is requested. Since image generation is the most demanding task for PopChart Server, this tremendously decreases the server load.
Note: If you want to save the file to your web application server, you should use the saveImageToAppServer(String, String) method.
Parameters The saveImageToPopChartServer() method accepts the following parameters.
The path to and location that you want to save your image to. This path will be relative to PopChart Server's document root. Make sure that your path.xml file permits PopChart Server to read from this path (see "Setting Path Permissions" in Chapter 3 of the PopChart Server User Guide). PopChart Server will automatically write over that file if it already exists.
|
|