================================================================================
aImport: Schedule importer of Agenda from iCal.
Version 1.00 (29 May 2009)
Noriyuki Mihashi
================================================================================
[Contents]
1. Summary
2. System reqirement
3. Installation
4. Uninstallation
5. Getting strt
6. Options
7. Note
8. Licences
9. Changes history
1. Summary
This program imports schedules from Mac's iCal into Psion's Agenda. It does
not sync both schedulers but do one-way importing from iCal to Agenda simply.
Six years ago I published a similar program 'aSync' what synchronize Agenda
with iCal. But 'aSync' has complex settings in order to do two-way syncing,
so it seems that some people thought it bothering to setup and wander to use
'aSync'. I often got e-mails of trouble or questions about settings.
It seemed that some people do not want two-way syncing but want just importing
iCal schedules into Agenda. So I made this program by reducing many features
from 'aSync'. Therefore you can use this program without complex settings if
you want only importing schedules from iCal into Agenda.
2. System reqirement
aImport has the following system requirements:
- Mac OS X (Ver.10.4 or later) and iCal on your Mac.
Mozilla Calendar on various platforms is also supported.
- Psion Series 5, 5mx, Revo or other compatible EPOC machines.
3. Installation
You will see the following files after expanding the ZIP archive.
./ ----- aImport.txt This text.
aImport.SIS Installation file.
aImportW.SIS Installation file for emulator.
srcs/ ------- aImport.opl Source lists.
aImport.oph
icon.mbm
Pick up the extracted 'aImport.SIS' file and install it on your Psion. While
you install aImport, Agenda2.OPX will also be installed automatically. When
installation is complete, the aImport icon will appear in the Extras bar on
your Psion.
If you install this program into the emulator, use 'aImportW.SIS' instead, or
it becomes error when it starts.
4. Uninstallation
If you have the 'Add/remove' icon in your Psion's control panel, select aImport
in the 'Add/remove' window and remove it. Or find the 'aImport' directory in
the '\System\Apps\' directories in drives C: and D: on your Psion, and delete
all the files included in them.
5. Getting start
To import iCal schedules into Agenda, take these three steps:
- Exporting schedules
- Transfering iCal file
- Importing
These are described following.
5.1. Exporting schedules
If you can find 'Export' in 'File' menu on the iCal's menubar, select it.
Then specify place and name to save iCal's schedule on the dialog window.
After this your schedules will be exported into an iCal file with suffix
'.ics'.
If you cannot find 'Export' in 'File' menu on the iCal's menubar, get iCal
file from '~/Library/Calendars/' directory on your Mac. You can find some
files with '.ics' suffix in there, and thie filename may equals to your
calendar name. For example, a calendar named 'Private' will be saved in
'~/Library/Calendars/Private.ics'.
5.2. Transfering iCal file
Transfer your iCal file exported to your Psion. There are several ways to
do it. If you using MacOS 10.5 (Leopard) or later, you can transfer a file
trough compact-flash memory card. Other way you can take is using utility
software such as Java Psion Link.
5.3. Importing
Start 'aImport' program on your Psion. Then you will see a dialog window.
There you can select an iCal schedule file and an Agenda file. Once you
input them, these will be already set when next startup.
When you press [Start] button or press enter key, program starts importing
and will exit after finish importing.
6. Options
This program has several options to control importing. They can be set on a
setup dialog window. You can open this window when you press [Options] button.
Options you can set on this dialog window are following:
Backup Agenda file:
If this item checked, this program copies Agenda file imports into. File-
name copied will be added '(0X)' its end as same as Psion's file copying.
Entry types imports:
Selecting entry types to import. Selectable types are appointments, events,
anniversaries, and to-dos. You have to select at least one type.
Delete old entries:
This program can delete exiting Agenda entries before importing to avoid
duplicated same entries when you import repeatly. By this option you can
specify deleting method from among 'Not delete', 'With symbol', 'Without
symbol' or 'Delete all'.
Entries deleted are only entry types you selected at 'Entry types imports'
option. If 'With symbol' is selected, deleted entries are only having sym-
bols of selected entry types. Symbol is a charactor set at 'Entry symbol'
option in detail property of Agenda entries.
Separator before place:
Psion's Agenda is not have a 'Place' field in its entries. If you specify
any charactor, this program sets location data in iCal entries to the end
of text with the specified separator inserted before. When no charactor is
specified, location data is not set.
7. Note
7.1. This program supports only US-ASCII character code. It is not supported
with other character codes, especially multi-byte codes such as Japanese.
7.2. This program does not support time zone or summer time. Information
on time zones are neglected and all time values are processed as local
time.
7.3. There are some differences in supported entry status among Agenda, iCal
and Mozilla. aImport converts entry status through importing using the
following rules:
iCal to Agenda)
Agenda iCal
-------------------------------------------------------------------
Appt, Event, Anniv: none <---- none
none <---- CONFIRMED
tentative <---- TENTATIVE
tentative + cross out <---- CANCELLED
To-do: none <---- none
cross out <---- COMPLETED
Mozilla to Agenda)
Agenda Mozilla
-------------------------------------------------------------------
Appt, Event, Anniv: none <---- CONFIRMED
tentative <---- TENTATIVE
tentative + cross out <---- CANCELLED
To-do: none <---- NEEDS-ACTION
cross out <---- COMPLETED
8. Licences
8.1. The copyright of this program and other related products distributed
together (source codes, icons, documents, etc.) belongs to the author of
this program, except the Agenda2.opx which belongs to Symbian Ltd.
8.2. This program is distributed as freeware by the copyrighter. No payment
is necessary for commercial or noncommercial use.
8.3. The author of this program accepts no claims for physical, mental,
material, monetary, social, religious, political or any kind of damages
caused by you using this program. Anyone who use this program must aban-
don all claims for all damages described above.
8.4. Those who have this program may reuse a whole or part of its source code
for their own products and can redistribute them freely for commercial
or non-commercial use without the permission of the copyrighter, except
the official application UID allocated by the Symbian Ltd.
8.5. Those who make their own products by reusing the source code of this
program may not prevent others from using this program and must allow
its free distribution, free use, free redistribution and free reuse by
claimimg their copyrights.
8.6. You agree to all the articles listed above in this chapter when you use
this program or reuse source code of it.
9. Changes history
Ver.1.00 (29 May 2009):
- Created as independent program from 'aSync' Ver.1.18.
aImport