What is meant by Sample Data? The Pollstar100 Web Content Manager enables designers to quickly and easily combine image and text and other resources with selected web-content in a way that allows the end-user browse, view and submit feedback about the selected web-content. This collection of selected web-content and associated resources is what is termed as the Pollstar100 Sample Data set. The Pollstar100 data set takes the form of a simple comma separated text file.
Creating A Sample Data File
In order to create Pollstar100 Sample Data files, designers can use a range of applications such as Excel; standard text editors such as Notepad -in fact any application capable of outputting UTF-8 encoded ASCII format CSV text files.
Here are the recommended (UNIX style) Sample Data file webserver file permissions:
|
Owner Group Public
|
|
rw rw rw (666)
|
The default Pollstar100 implementation will look for a Sample Data file named Pollstar100.csv in the same directory that the Pollstar100 Service PHP file resides in. While not a requirement, it is recommended the developers override this default and locate all Pollstar100 Sample Data sets on the webserver somewhere above the web-root. By doing so, the developer can ensure that external access to the Sample Data set is only provided via the Pollstar100 Service. Details on how this is achieved can be found in the following section:
Embedding The Pollstar100 Applet In An HTML Page
File Locking
When writing to the Sample Data file, the Pollstar100 Service will attempt to lock the file either using UNIX semaphores, or if this functionality is not present on the webhost system (and it won't be if the webserver is WinOS) then it will create lock files. If the latter method is employed, it will be necessary to ensure that the directory containing the sample data file also has world write permissions so that the Pollstar100 Service can create the lock file(s). Here are the recommended (UNIX style) Sample Data file directory file permissions:
|
Owner Group Public
|
|
rwx rwx rwx (777)
|
Sample Data Sets In Detail
The following section provides detailed information on how Sample Data sets are defined:
Defining Sample Data Sets





