PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Conditions for reading the PALM data
  • Principle
  • Details of different steps
  • Step 1: Opening an access with PalmLoad
  • Step 2: Reading the records found in the PALM database
  • Step 3: Refreshing the accesses (optional step)
  • Step 4: Closing the accesses
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Warning
From version 16, this feature is no longer available.
Overview
Reading the Palm Pilot data from a WINDEV application is directly performed in the Palm Pilot database found on the current computer. The Notepad, Calendar, Task List and Address Book databases are accessible. This data is accessible in read/write. See Modifying the Palm Pilot data for more details.
Conditions for reading the PALM data
To read the PALM data, you must:
  1. have HOTSYNC.EXE (synchronization tool of Palm Pilot) installed on the current computer.
  2. the data must have been synchronized once.
Special case: Using OUTLOOK or another PALM data manager (other than PalmDeskTop)
If the data coming from your Palm Pilot is not displayed in the PalmDeskTop manager, you will not be able to use the PALM database from a WINDEV application. In this case, use PalmReset to re-initialize your configuration.
Caution: if you are using PalmReset, your PALM data will no longer be accessible from OUTLOOK.
Principle
To read the records of a Palm Pilot database from a WINDEV application, you must:
  1. Open one or more accesses with PalmLoad.
  2. Read the records found in the PALM database.
  3. Refresh the access to the records if necessary (after a synchronization for instance).
  4. Close the accesses to the PALM data with PalmClose.
Details of different steps

Step 1: Opening an access with PalmLoad

PalmLoad is used to create a "View" of the data found in one of the Palm Pilot databases. This view is an Access. All the database records are loaded in memory and they can be handled by the PALM functions.
You have the ability to handle the records corresponding to a specific access. You have the ability to filter these records, read these records, ...
You have the ability to define several simultaneous accesses to a PALM database. These accesses can be performed on one of the databases of a single user: the data will only be loaded once in memory. You can for example define an access containing only the records found in the notepad of the WORK category at the same time as an access containing the records found in the notepad of the CUSTOM category. Each one of these accesses will be identified by its name.
Example:
The following code is used to create an access to the PALM "Notepad" database of the JEFF user. In case of failure, an error message is displayed and the program stops.
MyMemo is string       // String containing the message found in the notepad
IF PalmLoad("JEFFACCESS","JEFF") = False THEN
Error("Error while accessing the PALM database" + ErrorInfo())
EndProgram()
END
MyMemo = PalmReadFirst("JEFFACCESS")

Step 2: Reading the records found in the PALM database

To read the records found in a PALM database, all you have to do is use the read functions:
PalmOutAllows you to find out whether the PALM record on which you want to be positioned is outside the PALM file or the filter.
PalmListCategoryLists the different categories available for the current access.
PalmReadReturns an information about the current record: content of the record, its category or its position
PalmReadLastPositions on the last record of the specified access and reads this record.
PalmReadPreviousPositions on the previous record of the specified access and reads this record.
PalmReadFirstPositions on the first record of the specified access and reads this record.
PalmReadNextPositions on the next record of the specified access and reads this record.
PalmPositionPositions on the record identified by its position in the specified access and reads this record.
The different read functions are used to update the Palm structure. This structure is used to find out all the characteristics of the record. See Palm structure for more details.
PalmFilter is used to filter the records of an access.
PalmNbRec returns the number of records found in the specified access.

Step 3: Refreshing the accesses (optional step)

PalmRefresh is used to refresh the specified access. Therefore, if a synchronization was performed, PalmRefresh is used to load in memory all the modifications performed by the synchronization.

Step 4: Closing the accesses

When the management of Palm data is completed, you must close the accesses that were opened beforehand. This closing is performed by PalmClose. All the accesses are automatically closed when the application is closed.
Minimum required version
  • Version 9
Comments
Click [Add] to post a comment