This example illustrates the Web.URL action. This simple integrated web browser supports Hyperlinks using normal HTML <a href="mysite.com/index.html"> anchors! Additional HTML formatting tags supported are:
<H1>, <H2>, <H3>, <BR>, <P>
PDATWebLib
Official Website for additional information/Registration: http://www.gack-apps.com/WebLib
Release Date: 07/20/2005
Version: 1.4
Price: $9.95 USD
NOTE: Requires PDAT Pro!!! Work around for PDAT/Adv users is available...see included sample project for instructions on using a STUB/Launcher compiled with PDAT Pro to handle this library for your PDAT/Adv application!
This library is NOT...I repeat NOT compatible with PDAT/Adv. PDAT/Adv apps can add a STUB launcher application that was compiled with PDAT Pro and still add graphs! The STUB/Launcher gets ran from within your PDAT/Adv application using Call "crid", "type" and thats it!
SPECIAL NOTES:
Updated to include 2 different actions for updates! One for installers and zip files and one for updating the app prc itself! Other enhancements include web browser now supports Up&Down button for scrolling the web page.
Action Reference: |
||
|---|---|---|
Web.URL "URL", "Title"
|
|---|
This action takes first parameter and opens the URL in the Lib's own built-in browser! Does NOT require an installed third party web browser! Support includes very basic HTML to keep the parsing fast. Formatting tags supported: <H1>, <H2>, <H3>, <BR>, <P>
Hyperlinks supported as well!!! (ie: <a href="http://www.gack-apps.com/MyName.prc>Download</a>) These hyperlinks can be used to download virtually any file type. Palm files such as PDB and PRC's are prompted for save to the devices RAM, while all others with prompting for save to expansion card if available or as a streamFile in RAM.
Web.URL "http://www.gack-apps.com/weblibdemo.html", "Gack's Page!"
Web.GetFile "FileURL"
|
|---|
This action connects and attempts to download the file specified in the FileURL parameter. NOTE: This must be a COMPLETE URL. Palm Files, such as PRC and PDB's are prompted for save to the devices RAM. Non palm files, such as ZIP files are prompted for saving to an available expansion card (if available) or to RAM as a streamFile.
Web.GetFile "http://www.gack-apps.com/MyName.prc"
Web.Update "installed version", "UpdateURL", "VersiontxtURL" |
|---|
This action(s) allows for you to offer a downloadable update for your users. It's an intelligent updater though as it only prompts for download if the version you script as the installed apps version ("installed version") is lower than that of the version parsed out of the downloaded text file found at "VersiontxtURL". If the versions are the same, then a message is displayed letting the user know there are no new updates available. If the version in the text file is higher, then they are prompted to download the newer version, which is found at "UpdateURL" location.
The primary difference between the two actions is that Web.Update expects to download an installer (such as a NutShell archive to RAM, or a Zip file to VFS card) and does not EXIT the application to do this. The latter, Web.Update.AppFile however is now available for those of you not wishing to use Nutshell and allows you to update the application.prc file itself. NOTE: To avoid duplicate files in RAM and to ensure this update is successful, the FILE name of the update that is being downloaded MUST be different than that of the one currently installed. By this I mean the name as seen by the Palm OS. This is NOT necessarily the same as what is seen on the Launcher! In PDAT apps, the NAME of your application is the name you provide in the "Application Name:" section in the PDAT IDE. So...an example of proper naming convention would be like this:
Original Release: WebMaster10 (for WebMaster Version 1.0)
Next release: WebMaster11(for WebMaster Version 1.1)
That is just an example, the point being that they MUST have different names, or there will be no way the library will be able to tell them apart and delete the correct file after downloading the update! You set the name that is visible in the Launcher, in the App/EndApp code block using the TITLE keyword. After the update has been made, there will be no visible difference to the user. To see this in action try the demo I've included. It's Name is WebLib!.prc, but shows up as Web-Lib! on the launcher. Run the Update for AppFile, and once it downloads and exits, rerun the application and you will see that it is indeed a NEW version. If you look at the file name in rsrcedit, you'll see that it is now WebLib2, but still reads Web-Lib on the launcher....WebLib! was deleted after successfully saving WebLib2 to RAM! :)
Web.Update "1.2", "http://www.gack-apps.com/DB/Debit-BuddyV1.3.prc", "http://www.gack-apps.com/DB/Version.txt"
Parameters explained:
installed version : String literal of the existing installed applications version. IE: "1.2"
UpdateURL: COMPLETE URL to the downloadable update. Ideally a zip file for storage on expansion card or a Nutshell installer and saved to RAM.
VersiontxtURL: COMPLETE URL to a text file(*.txt) containing the version number of the most recent version available. ie: "1.3" MUST BE IN DOUBLE QUOTES!
SPECIAL NOTES: Version #'s supplied both as literal parameter (param #1) and in the contents of the txt file (Param #3) MUST be legit NUMBERS. By that I mean something like the examples following. ALSO note, that the version number must be in Parantheses as shown as well! A search is performed of this text file and an attempt is made to parse out the version BETWEEN two parantheses'! Failure to provide a text file in proper format will cause this action to fail and an alert about invalid file format being presented. You my
"1.0"
"1.999"
"4.09"
NOT SOMETHING LIKE:
"1.5.2"
"v1.5"
"2.4f"
Web.FTP.Basic "IP|URL", "Port", "Login", "Password", "Directory", "FileName", "SEND|GET"
|
|---|
This action connects and either SENDS or GETS the file specified from the described FTP server. The Directory paramater, though required, can be an empty string (ie: "").
Web.FTP.Basic "www.myFTP.com", "21", "MyLogin", "Pass123456", "/MyFolder", "MyDataBase", "SEND"
Parameters explained:
IP|URL: This can be the actual IP or the URL to the FTP server.
Port: The PORT # to connect to. Typically this is "21".
Login: Your User Login Name.
Password: Your user Password
Directory: Path to directory if NOT the startup directory. Please note...to use the default directory use "" for this parameter (empty parans)
FileName: File to SEND or GET. NOTE: For GET, you must provide an extension (ie: .prc, .pdb), for GET an extension will automatically be created based upon the FILES TYPE property. All files with TYPE= "appl", get the extension .prc appended to the Filename, all others get .pdb appended.
SEND|GET: Use one or the other to indicate the operation direction requested.
Web.SMTP "SMTP-Server",
"Port", "Login", "Pass", "To", "From", "Subject", "Body"
|
|---|
This action connects to the SMTP server specified and attempts to login and
send the email as detailed by the parameters in this action. This action
requires that the SMTP server uses Base64 encoded Authentication (AUTH LOGIN).
It is my understanding that most do. I cant speak for SSL as at the
time, I've not experimented with connecting and sending to any SMTP servers
requiring SSL.
Web.SMTP "smtp.mydomain.com", "25", "MyLogin", "MyPass", "myfriend@yahoo.com", "sales@gack-apps.com", "[SUBJ]", "[BODY]"
SMTP-Server: String literal or PDAT field containing the address of the
SMTP server to connect to
Port: Port # to connect to, typically this is 25
Login/Pass: Your specific login and password used to login to the
smtp server. You'll need to get this from you provider.
To/From/Subject/Body: Self explanatory. These are what they
indicate they are, nothing cryptic here.
1.) Extract the PDATWebLib.dll file from the archive and copy to your PDAToolbox Installation folder. Typically something like: C:\Program Files\PDAToolBox 2.) In PDAToolbox launch the Script Editor (SE) and click the Tools Icon to access the SE's compiler options. Select the "Libraries" tab, then click "Add". Use the file selection dialog to navigate to your PDAToolbox installation folder and select the "PDATWebLib.dll" file you just extracted here in Step #1. If you have a registration code, you may enter it into the info/license dialog box at this time as well. If your trialing this library, then leave these fields blank. Your done! *To register at a later date, return to the SE's compiler options dialog box, click the "Info/Lic" button and enter your registration information and click the OK button. |
|
|
|
|
| This screenshot shows an example of Web.Update in action. It compares the scripted version against a version found in a txt file saved on the website and prompts to upgrade if its higher/newer. | Another shot of the Web.Upgrade in action. In this SS you see the dialog box presented to the user to confirm the download of the newer version to the devices RAM. |
|
|
| This example demonstrates the Web.GetFile action. In this example, the file being requested to download is a ZIP file and as such, is prompted for save to the expansion card instead of RAM. | This example illustrates the Web.URL action. This simple integrated web browser supports Hyperlinks using normal HTML <a href="mysite.com/index.html"> anchors! Additional HTML formatting tags supported are: <H1>, <H2>, <H3>, <BR>, <P> |
| Back to Top | |
v1.4 07/20/2005-Includes a new SMTP E-Mail sending action! Not all SMTP serves may be compatible.
v1.2 03/27/2005-Includes a new FTP action for SEND & GET (upload & download) from an FTP Server.
v1.1 01/28/2005-Includes a new action for app.prc updates, and some other minor additions
v1.0 01/26/2005- Initial release. Three flexible and unique actions in all!
| Warranty and User License Agreement |
"The Software" is "PDATWebLib" by Brian Gackenbach dba Gack-Apps.
DISCLAIMER #1 - MUST READ
This product is an "After-Market" utility for PDA Toolbox(tm) and as such, is subject to obsolescence by changes in PDA Toolbox or the Palm OS(tm) itself. This cannot be prevented. I may choose to stop or limit development and support of this product if such situation occurs.
USER LICENSE AGREEMENT
This Agreement sets forth your licensed rights to use "The Software" and is granted to you upon condition that you accept the terms of this license. Your electronic indication of agreement, or your use of the program constitute acceptance of all of the terms of this license.
The program copy and documentation are furnished to make "The Software" available for your use and remain the property of Gack-Apps.
IF YOU DO NOT AGREE WITH ANY PART OF THIS LICENSE, DO NOT USE THIS SOFTWARE. Delete "The Software" and all associated files from all media on which it has been copied.
LICENSE TERMS AND CONDITIONS
THE LICENSED PRODUCT
"The Software" comprises copyrighted computer programs and utilities for the Graphing of Palm OS(tm) application databases (PRC) created by the PDA Toolbox(tm) Application Generator. The Licensed Product in its entirety is protected by US and foreign copyright. YOU MAY NOT DISTRIBUTE THE LICENSE CODE provided to you.
YOUR USE OF THE LICENSED PRODUCT
General Use. You have the right to use "The Software" with PDAToolBox(tm) Professional Versional and to distribute the library file itself "PDATWebLib.prc". For those purposes, you have the right to install the "The Software" and any associated files on one (1) computer. Use of "The Software" on a network or any other arrangement by which its functions are accessible to more than one user at a time is not permitted.
LIMITATIONS ON USE
General Use Limitations. You have no right to reproduce, transfer, publish or otherwise distribute either the "The Software" software, or any components or documentation provided.
ALL RIGHTS NOT SPECIFICALLY GRANTED BY THIS LICENSE ARE RESERVED BY GACK-APPS.
WARRANTIES, WARNING, DISCLAIMER
Warning and Disclaimer of All Warranties. THE PROGRAM IS FURNISHED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, IN ALL JURISDICTIONS WHERE ALL WARRANTIES MAY BE DISCLAIMED IN THE LICENSING OF INTELLECTUAL PROPERTY.
PDAT/Advanced is copyrighted by Richard R. Sands dba Sands USA.
PDA Toolbox (PDAT) is copyrighted by Paul Prejean.
Quartus RsrcEdit is apparently not copyrighted, but is maintained by Quartus at www.Quartus.net.
Windows is a trademark of Microsoft Corporation.
And ever present...