help.txt

moblie syncml mail javame

Help for BlackBerry devices

=== Introduction
The following instructions are for BlackBerry devices. The options on your device may vary slightly from these instructions depending on your handset. If so, consult your BlackBerry documentation for further information.

=== Application Start
Funambol will start automatically when your device boots up. If the "Get mail" option in Settings>General is set to scheduled sync (e.g. Every 15 mins), the application will also start automatically when it needs to sync if it is not already running. To start the application manually, click the Funambol icon from the device home page or from where you've installed the Funambol application.

=== Hiding the client
You may run Funambol in the background. The main benefit of running Funambol in the background is that you will continue to receive new emails while you're using your device for other tasks. To run Funambol in the background:
- While in the inbox, press the Menu key, and then select "Run in Background" from the menu; or
- Press the End key
While Funambol is running in the background, a small yellow envelope will appear next to the Funambol icon to indicate there are new emails in your inbox for you to look at. To bring the application to the foreground, click on the Funambol icon from the device home page or in the main menu. Once you view your inbox by bringing the application to the foreground, the new mail indicator (small yellow envelope) disappears. 

=== Internet access
Funambol will attempt several built-in mechanisms for establishing a connection with the server to send/receive emails and deliver push notifications. If these attempts fail or if you would like to override these built-in mechanisms, you may enter your mobile operator's APN (Access Point Name), Username and Password into Options>Advanced Options>TCP on your BlackBerry device. The application will use the values you entered for establishing the connections needed. IMPORTANT: Using Funambol may result in costly data charges. Please contact your mobile operator to ensure that you have the proper data plans and settings before using Funambol.

=== Contacts sync
Every time you start Funambol on your phone, your contacts and their email addresses stored on the server are automatically synchronized with your email client. They are available when you compose messages, eliminating the need to manually type in email addresses.

=== Push service
Once the "Push service" connection is established, every time a new message is detected in your email account (e.g. Gmail, Yahoo!, AOL, Hotmail), a "Push" alert is sent to your device, which automatically starts to download your new emails whether Funambol is running in the foreground or in the background. If the connection cannot be established, the application will use the "Get mail" option in Settings>General to determine how to send/receive emails. The default is to perform a scheduled sync every 10 minutes, while trying to re-establish the "Push service" connection. 

Note: in order to receive "Push" alerts, Push service must be enabled for your account on the server/portal you're accessing.

Note: by setting "Get Mail" to "Push service", TCP/IP will be used to push email message from the server to the application.

=== Scheduled sync
In addition to being able to manually press "Get Mail" to download your new messages, you may also set up the Funambol client to perform this operation regularly at a pre-defined interval:
1- While in the inbox, click the Menu key, then select "Settings", then "General"
2- In "Get mail:", select your desired interval for sending/receiving (e.g. every 5 minutes, every 30 minutes, etc...)
3- Click the Menu key and select Save.

Scheduled synchronization works whether the Funambol application is running or not. If Funambol is not running, scheduled sync will auto-start the application.

Note: if you exit the application by selecting Menu > Exit, you will be prompted to allow the application to connect at the scheduled time; if you answer "yes", the application will autostart when required. If, on the other hand, you exit the application by pressing the red key, you will not receive this alert.

=== Viewing attachments
If a message contains any attachments, you will see a paperclip icon next to the sender name; select "Attachments List" from the menu to see a list of the attached files. 
If the content type is supported by your phone, select "Open" to view the attachment: you will be prompted to allow Funambol to launch your device's browser to display the attachment. Depending on your device's browser's capabilities, you may have the option of saving the attachment.
Exit the browser to return to Funambol.

=== Tips & tricks
- Use the * key to flag emails while in the inbox. If you're connected to an IMAP email account, the flag status of your emails will be exchanged between your email server and the Funambol email client at the next synchronization.

- Press 0 to delete emails while in the inbox.

- Deleting messages on the client will not delete message on the email server unless you do the following (please notice that some providers might block this funtionality):
  1- While in the inbox, click the Menu key, select "Settings", then "General"
  2- Set "Delete messages" to "Device & Server"
  3- Click the Menu key and select "Save" to store the updated configuration

- Search for a Contact: While looking at the contacts list, you may find specific contacts by spelling out their name or email address using T9-style typing on your phone's alphanumeric keypad (e.g. for "Andy", press 2639). To clear the search criteria and show all of your contacts, press 0 on your phone's keypad.

- Call sender: While viewing a message, you may initiate a phone call to the sender of the email if the sender has a home, work or mobile phone number defined on the Funambol portal/server. To perform this operation, select "Call Sender" from the menu while viewing a message. If the user has more than one phone number, you will be prompted to select which phone number you'd like to call.

Note: in order to use the call sender function and the open link function, you will need to exit the client.