https://sourceforge.net/p/ngcalsync/wiki/Home/Recent changes to HomeenThu, 31 May 2012 06:43:27 -0000https://sourceforge.net/p/ngcalsync/wiki/Home/<pre>--- v1 +++ v2 @@ -1,8 +1,61 @@ -Welcome to your wiki! +Welcome to _ngcalsync_. -This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage]. +# What's this? +Did you ever wanted to synchronize your company meetings from Lotus Notes with your Google calendar? +Yes? Then you are facing some obstacles: -The wiki uses [Markdown](/p/ngcalsync/wiki/markdown_syntax/) syntax. +* your sensitive data must not go to Google (“Meeting at 12 o’clock with customer John Doe …”) +* you do not want to get your Lotus Notes calendar tainted by your private entries from Google +* you do not want to have your colleagues’ birthdays in Google +* you like to select which kinds of calendar events are synchronized +* you are using Lotus Notes :-) +Since I did not find an application offering solutions to all these problems at the same time, I decided to write my own. -[[project_admins]] -[[download_button]] +# A word of warning +This application is designed to make your Google calendar a (partial) copy of your Lotus Notes calendar. +This means, it will erase all events in your configured Google calendar which are not in your Lotus Notes calendar or excluded from synchronisation by your settings. +Be sure to use a dedicated Google calendar for synchronisation. + +# Running +## First start +Just run the application. It will create a folder .ngcalsync in your home directory. Now you can edit the created file sync.properties according to your needs. + +All configuration is done in .ngcalsync/sync.properties, which is read at program startup. This file is well-documented. + +## First time authorisation +### Lotus Notes + +1. Include the path to your Lotus Notes client installation in your PATH-variable. +2. Start your Lotus Notes client. +3. Click File → Security → User Security (Macintosh OS X users: Lotus Notes → Security → User Security). +4. Click Security Basics, and select “Don’t prompt for a password from other Lotus Notes-based programs (reduces security)” under “Your Login and Password Settings.” +You can also skip steps 3 & 4, but then you have to enter your Lotus Notes password in the console every time you start the application. + +### Google + +Now run the application. + +Since you haven’t yet authorized the application to access your google calendar, it will open the authorisation website in your favourite browser, if possible. If not, it will prompt the URL to console, so you can manually go to the website. +On the website, click allow to authorize the application to access your google calendar. It will give you an access token, which you can paste into your console and hit enter. The application will store your access token in .ngcalsync/user.secrets. +Afterwards the application will synchronize your Google calendar according to your Lotus Notes calendar and log a summary of the changes. + +# Sensitive data protection +Regardless which kinds of events you choose to synchronize to your Google calendar, the application will never write sensitive data to Google. All event data is obfuscated by setting the title to the type of the event and removing everything but the start and end date and time. + +Let’s say, you have an 3 hour meeting with John and Jane at 11 o’clock a.m. on 2001/11/9 in your company’s meeting room at World Trade Plaza, New York, discussing international flight regulations. + +When you synchronize this to Google, it will be seen as + +Summary | Meeting +----------- | -------- +Starting at | 2001/9/11, 11 a.m. +Ending at | 2001/9/11, 2 p.m +Description | – +Attendees | – + +No sensitive data is written to Google. + +# Bug reporting +Feel free to report bugs. If I have the time, I will look at them, if not, I won’t. + +Enjoy! </pre>Frank JakopThu, 31 May 2012 06:43:27 -0000https://sourceforge.netd6a33d5418947f97a4d1d6a5f45ad001f04cd74bhttps://sourceforge.net/p/ngcalsync/wiki/Home/Welcome to your wiki! This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage]. The wiki uses [Markdown](/p/ngcalsync/wiki/markdown_syntax/) syntax. [[project_admins]] [[download_button]] Wed, 30 May 2012 07:02:10 -0000https://sourceforge.nete5611d729de16d02ea8d3a989909187232f61064