Краткое описание



Скачать 111.94 Kb.
Дата08.11.2016
Размер111.94 Kb.
Просмотров318
Скачиваний0
ТипПрограмма
Outlook2VCard
версия: 1.08

Последнее обновление программы в шапке: 30.04.2013

Краткое описание:
Читает контакты из MS Outlook и записывает их в файл VCard.

Описание:
Работает на настольном ПК. Программа читает контакты из MS Outlook и записывает их в файл формата VCARD для последующего импорта в Контакты Android OS. Тестировалась с HTC Desire под Android 2.2, Windows XP, Vista, Windows 7 (32 bit) с MS Office 2007.

Программа разработана для тех, кто так же как и автор программы давно пользуется Контактами MS Outlook, принципиально не хочет синхронизировать свои контакты через аккаунт Google, испытывает отвращение к существующим программам синхронизации (ввиду их убогости) и искренне не понимает, как можно в России продавать девайсы, в контактах которых не поддерживается поле Отчество (MiddleName).

Программа написана на языке java (требуется JRE версии 6 (1.6) или выше) и работает в командной строке. Контакты из Outlook записываются в один файл VCARD (vcf). Поддерживаются кодировки UTF-8, CP1251. Могут обрабатываться все контакты или только выбранные. Настройки программы: состав записываемых полей, имена тегов и другие, хранятся в ini-файле и могут быть изменены пользователем. Поддерживается импорт фотографий контактов из Outlook.

========================================================

Copyleft, 2008 - 2013, Ursus.

Программа читает контакты из MS Outlook и записывает их в файл формата vCard для последующего импорта в

Контакты Android OS. Тестировалась с HTC Desire под Android 2.2, Windows XP, Vista, Windows 7 (32 bit) с MS Office 2007.

Пользователи программы подтверждают работоспособность программы в 64-битных версиях Windows и с MS Office 2010.

Распространяется свободно и без каких-либо обязательств со стороны разработчика.

Последняя версия доступна по адресу: http://4pda.ru/forum/index.php?showtopic=224942&st=0

========================================================

Программа разработана для тех, кто так же как и автор программы давно пользуется Контактами MS Outlook, принципиально не хочет синхронизировать свои контакты через аккаунт Google, не доволен существующими программами синхронизации и искренне не понимает, как можно в России продавать девайсы, в контактах которых не поддерживается поле Отчество (MiddleName).

Программа написана на языке java (требуется JRE) и работает в командной строке. Контакты из Outlook записываются в один файл vCard (vcf). Программа поддерживает:

- различные кодировки текста (по умолчанию UTF-8);

- кодирование полей ENCODING (по умолчанию кодируются поля, содержащие текст);

- обработку всех контактов (по умолчанию) или только выбранных (см. раздел "Использование");

- возможность задания собственного формата для отдельных полей. Так, например, Отчество можно записать в поле Имя в формате "Имя = Имя + отчество" (формат по умолчанию);

- возможность задания альтернативного формата для полного (отображаемого) имени, на случай, если основной формат даст пустое значение;

- импорт фотографий контактов из Outlook;

- возможность дописать значения полей (например тех, для которых в целевой системе импорт не предусмотрен) в поле NOTE (Заметки или Комментарии);

- хранение настоек в файле (ini-файл).

1. Инсталляция

Скопировать содержимое папки Deploy, включая каталог \lib, в любой удобный для Вас каталог на жестком диске. Можно запускать с внешнего носителя, не копируя на жесткий диск.

Содержимое каталога Deploy (файлы, необходимые для работы програмы):

Outlook2vCard.bat - bat-файл для удобного запуска программы (параметры по умолчанию);

Outlook2vCard.jar - собственно программа Outlook2vCard;

Outlook2vCard.ini - файл настроек (используется по умолчанию);

Outlook2vCard-Desire.bat - для подготовки vcf-файла, сформатированного для импорта в HTC Desire;

Desire-Setts.ini - файл настроек для HTC Desire (используется в Outlook2vCard-Desire.bat);

jacob-1.16-x64.dll,

jacob-1.16-x86.dll - динамические библиотеки пакета jacob (тестировалась только 32-х разрядная версия!);

Supported_Fields.xls - перечень полей, обрабатываемых программой, с указанием параметров и значений по умолчанию;

lib\

commons-codec-1.4.jar - библиотека для QuotedPrintable, Base64 и B-кодирования



jacob.jar - библиотека для работы с COM-объектами

ini4j-0.5.2-*.jar - библиотека для работы с ini-файлами

README.TXT - этот файл

В фале outlook2vcard-src.zip - хранится исходный текст программы.

Для работы требуется Java Runtime Environment (JRE) версии 6 (1.6) или выше.

2. Использование

Поддерживаемые параметры командной строки:

-с - имя файла конфигурации. Например: -c=config.ini. Если не указано - по умолчанию используется Outlook2vCard.ini. Если имя файла указано, а его нет - программа завершит работу.

Настройки программы по умолчанию:

- версия формата vCard (VERSION) - 2.1

- обрабатываются все контакты, а не только выбранные (ALL=false);

- кодировка (CHARSET) - UTF-8;

- язык (LANGUAGE) - ru-RU;

- даты не "округляются" (ROUND-DATE=false);

- формат для полного (отображаемого) имени - FullName=LastName, FirstName MiddleName;

- альтернативный формат для поля FullName (ALTERNATE-FULLNAME) - CompanyName - JobTitle.

Кодирование ENCODING и параметры CHARSET, LANGUAGE применяются для записи полей: N, FN, ORG, TITLE, ROLE, ADR, NOTE, NICKNAME, CATEGORIES, а также полей ManagerName, AssistantName, Spouse.

Полная информация об обрабатываемых полях - в файле Supported_Fields.xls

Особенности использования файла настроек отражены в комментариях в файле Outlook2vCard.ini.

Для пользователей HTC Desire имеется готовый файл настроек Desire_Setts.ini и Outlook2vCard-Desire.bat - для запуска программы с этими настройками.

Файл vCard создается в том же каталоге, откуда Вы запускаете программу. Он имеет имя YYYY-MM-DD-foldername.vcf, где YYYY - текущие год, MM - месяц, DD - день, foldername - имя папки контактов. Если файл с таким именем уже есть, то к его имени будет добавлен порядковый номер - (N). Обратите внимание (!), что в версиях программы младше 1.07 номер к имени файла не добавляется, он просто перезаписывается без предупреждения. Если у Вас не одна папка с контактами - будет создано по одному vcf-файлу для каждой папки. После этого файл можно перенести на Android-устройство (или куда-нибудь еще) и импортировать контакты из этого файла.

Вывод программы в консоль Windows настроен на кодировку cp866 (используется по умолчанию). Если вы меняли настройки Windows, пожалуйста измените параметр -Dfile.encoding=Cp866 в bat-файле для корректного отображения вывода программы.

Для того, чтобы получит возможность выделить контакты в Outlook необходимо добавить Контактам поле "Выбрано".

Как это сделать:

- переключить текущее представление Контактов Outlook в табличный вид, например в вид "По категориям";

- щелкнуть правой кнопкой мыши на "шапке" таблицы (заголовках столбцов) контактов и в появившемся контекстном меню выбрать пункт "Выбрать поля";

- в появившемся окошке нажать внизу кнопку "Создать";

- создать поле с именем "Выбрано", тип - "Да/Нет", формат - "Значок".

Новое поле можно просто перетащить на "шапку" таблицы. После этого с ним можно будет работать, выделяя контакт щелчком мыши и устанавливая флажок в столбце "Выбрано".

Обратите внимание, что после запуска программы от Вас может потребоваться дать разрешение на доступ программы к Контактам Outlook. Если после запуска программы Вы не видите никакой реакции, обратите внимание на панель задач Windows, возможно, Outlook уже запущен и запрашивает разрешение на чтение Контактов. Необходимо переключиться в Outlook и дать такое разрешение, установив флажок "Разрешить доступ". Если этого не сделать, а просто нажать кнопку "Разрешить", то Outlook будет запрашивать разрешение на чтение каждого контакта.

Информация о работе программы, сообщения об ошибках записываются в лог-файл outlook2vcard.log, в каталог, указанный в переменной окружения TEMP. Открыть его можно набрав в строке "Выполнить" (вызывается из стартового меню, кнопка "Пуск") команду: %TEMP%

3. История

Версия 0.90 - первый релиз программы от 13.03.2011

Версия 0.91 - 21.03.2011. Доработана процедура обработки пустой даты дня рождения для корректной работы в разных версиях MS Outlook.

Версия 0.92 - 2.04.2011. Основные изменения:

- добавлен параметр командной строки -o. Если он указан, Имя и Отчество записываются в vcf-файл раздельно. Если не указан, то имя записывается в формате Имя = Имя + Отчество (Полезно, например, для телефонов HTC). Для запуска программы с этим параметром добавлен файл Outlook2vCard - ordinary name.bat.

- теперь, если обрабатываются все контакты (параметр -a), а контактов в MS Outlook нет, или обрабатываются только выбранные контакты, а выбранных контактов нет, файл контактов не создается.

- расширен вывод информации о режимах работы и действиях программы.

- дополнительные файлы запуска перенесены в подкаталог bat-files.

Версия 0.93 - 4.04.2011. Добавлена обработка полей:

- Anniversary (Годовщина);

- WebPage (URL);

- NickName (Ник).

Версия 1.0 - 18.05.2011. Существенная доработка программы:

- удалены все параметры командной строки, за исключением -с, значение которого (ВНИМАНИЕ!) изменилось. Настройки вынесены в ini.файл;

- несколько изменилась логика работы (ВНИМАНИЕ!) - теперь по умолчанию обрабатываются ВСЕ контакты;

- изменился формат записи имени (ВНИМАНИЕ!) - теперь по умолчанию записывается: Name=LastName;FirstName;MiddleName;Title;Suffix. Такой формат соответствует спецификации vCard. Для устройств, на которых Отчество не понимается, можно задать настройку в ini-файле (в секции [FieldsFormats]): Name=LastName;FirstName MiddleName;;Title;Suffix.

- появилась возможность задавать форматы для отдельных полей;

- появилась возможность дописывать нужные поля в NOTEs (Заметки, Комментарии);

- добавлена обработка ранее не обрабатывавшихся полей Outlook: Gender, ManagerName, AssistantName, Spouse, IMAddress, Anniversary, PagerNumber;

- в тестовом режиме поддерживается спецификация vCard 3.0.

Версия 1.01 - 14.06.2011. Внесены следующие изменения:

- реализована обработка всех папок с контактами, если они создавались пользователем, а не только папки с контактами по умолчанию;

- реализована запись информации о работе программы и сообщений об ошибках в LOG-файл (%Temp%\outlook2vcard.log);

- добавлена обработка полей OtherTelephoneNumber (Другой), CarTelephoneNumber (Автомоб.);

- добавлена обработка исключительных ситуаций, связанных с неподдерживаемыми типами вложений в контакты;

- изменено значение параметра LANGUAGE по умолчанию. Теперь он равен ru-RU;

- если указать в ini-файле LANGUAGE= , то параметр LANGUAGE не будет использоваться в vcf-файле.

Версия 1.02 - 10.08.2011.

- устранена ошибка, возникавшая при работе с контактами, имеющими фотографии, если их более 99 ;

- обновлены библиотеки пакета jacob.

Версия 1.03 - 7.09.2011.

- устранена ошибка, возникавшая при очистке временного каталога Outlook от временных файлов фотографий.

Версия 1.04 - 13.10.2011

- учтены особенности работы с реестром Windows в зависимости от версии ОС. Ошибки могли возникнуть в Windows Vista и Windows 7 в учетных записях с кириллическими именами при обработке контактов с фотографиями числом более 99

Версия 1.05 - 12.01.2012

- учтены особенности работы с фотографиями, которые добавлены к контактам Outlook в результате синхронизации сторонними программами (свойство FileName вложения = Photo, а не ContactPicture.jpg). В предыдущих версиях программы такие фотографии пропускались;

- учтены особенности работы с контактами без фотографий в различных версиях Outlook, которые могли приводить к аварийному завершению программы.

Версия 1.06 - 18.04.2012

- осуществлен переход на библиотеку Jacob версии 1.16;

- устранена ошибка, которая могла возникать при обработке элемента, содержащегося в папке контактов, с MessageClass, отличным от стандартного IPM.Contact.

Версия 1.07 - 6.02.2013

- изменена логика работы с файлами vcf, в которые записываются контакты. Теперь, если на диске уже есть файл с таким же именем, новый файл записывается с именем, к которому добавляется порядковый номер;

- добавлена обработка исключительной ситуации, которая возникает, если программа не может получить доступ к Outlook.

Версия 1.08 - 30.04.2013

- добавлена возможность автоматического исправления ошибок (плюс-минус одни сутки) в датах (днях рождения, годовщинах), которые могут возникать в связи с отменой или вводом летнего/зимнего времени, сменой часового пояса. Программа выполняет простое округление даты-времени до ближайшего значения даты. Для этого добавлен новый параметр ROUND-DATE в секцию [Settings] ini-файла. По умолчанию "округление" дат не выполняется (ROUND-DATE=false).

Последняя версия программы доступна по адресу: http://4pda.ru/forum/index.php?showtopic=224942&st=0

4. Предупреждения и ограничения

Перед использованием программы установите на компьютер Java Runtime Environment (JRE). Скачать последнюю версию JRE можно со страницы: http://www.oracle.com/technetwork/java/javase/downloads/index.html. Если JRE уже установлена на компьютере, желательно обновить ее до последней версии. Для работы программы необходима версия JRE не ниже 6 (1.6).

Программа корректно работает в руссифицированных версиях Windows XP, Vista, 7 (кодировка cp1251). В версиях Windows, локализованных для других стран, там где в именах учетных записей используются символы в национальных кодировках (отличные от стандартных ASCII), могут возникать ошибки.

Обратите внимание: "Отображаемое имя" (поле FN) записывается по умолчанию в формате "Фамилия, Имя Отчество".

Если "Отображаемое имя" контакта окажется пустым (нет ни фамилии, ни имени, ни отчества) - вместо него (по умолчанию) будет записано "Организация - Должность" или, если "Организация" не указана, - просто "Должность". Формат альтернативной записи можно изменить с помощью тега ALTERNATE-FULLNAME в секции [Settings] файла настроек.

Качество фотографий, записанных в vcf-файл из Outlook будет невысоким. В Outlook фотографии храняться с низким разрешением.

О поддержке спецификаций vCard. В текущей версии поддерживаются спецификации 2.1 и 3.0. Поддержка версии 2.1 наиболее проработанная и обеспечивает перенос контактов на устройства с OS Android с максимально возможной полнотой. Версия 3.0 поддерживается в тестовом режиме. Основные различия в алгоритме записи контактов в vcf-файл между версиями 2.1 и 3.0:

- запись параметров тегов в версии 3.0 в формате TAGNAME;TYPE=PARAM1,PARAM2..., вместо TAGNAME;PARAM1,PARAM2...;

- для кодирования полей в версии 3.0 используется алгоритм кодирования ENCODING=B (фактически - BASE64), вместо ENCODING=QUOTED-PRINTABLE;

- параметр CHARSET в версии 3.0 не используется;

- по умолчанию в файл записываются поля NickName и Categories.

Соотвествие заданных настроек версии спецификации программой контролируется только по наименованиям тегов. В случае несоответствия - выдается предупреждение. Таким образом, отвественность за формат vcf-файла ложится на пользователя, изменяющего настройки по умолчанию.

Возможность загрузки тех или иных полей в конкретную программу управления контактами зависит от реализации в ней процедуры импорта. Практика показывает, что спецификации vCard разработчиками интерпретируются совершенно по-разному, а иногда они их просто не соблюдают. Будьте внимательны и осторожны: не потеряйте свои контакты!

Относительно исправления ошибок в датах. Автоматическое "округление" дат рекомендуется только в тех случаях, когда вы заметили регулярные ошибки, значения которых не превышают одних суток. Программа "округляет" даты, основываясь на предположении, что ошибка возникла по причине отмены/ввода зимнего/летнего времени или смены часового пояса и ошибка во времени (т.к. в Outlook дата хранится как дата + время) не превышает 12 часов. Так как причина ошибок в датах может иметь иной характер, а их значения быть больше 12 часов, решение об "округлении" дат пользователь должен принимать с осторожностью! Информация о контактах и полях дат, значения которых были откорректированы, выводятся на экран и записываются в лог-файл.

Программа тестировалась разработчиком только в 32-х разрядных версиях MS Windows. Пользователи сообщают, что она работает и в 64-х разрядных версиях.

5. Благодарности

Большое спасибо всем, кто использовал программу и прислал свои отзывы о ней, дал замечания и предложения по ее улучшению. Особая благодарность за дельные предложения - Ивану Лактионову.



Надеюсь, что программа будет для вас полезной.

Поделитесь с Вашими друзьями:


База данных защищена авторским правом ©nethash.ru 2019
обратиться к администрации

войти | регистрация
    Главная страница


загрузить материал