понедельник, 30 марта 2009 г.

ITVSystems Golden Gate. Обновление и экспорт отчетов

В новых версиях ITVSystems Golde Gate 2002 появилась возможность экспорта-импорта данных посредством командной строки. Вот краткая инструкция:
Описание командной строки утилиты экспорта/импорта данных



GGDataExchange.exe [-l логин] [-p пароль] [-txt | -xml]
[-export экспортируемый_файл |
-import импортируемый_файл [-header "строка_заголовка"] |
-report "параметры отчета"]

-l логин - параметр для указания логина администратора, под которым
выполняется подключение к "Золотым Воротам".

-p пароль - пароль администратора

Если логин не указан, но указан произвольный пароль, то
утилита попытается подключиться с пустым именем (это
необходимо, если в базе данных не зарегистрировано ни
одного оператора).

Если логин указан, но пароль не указан, то утилита
попытается подключиться с пустым паролем.

Если указан логин и/или пароль, то утилита не будет
запрашивать логин и пароль у пользователя, а будет
использовать логин и пароль из командной строки.

Если не указан ни логин, ни пароль, то утилита будет
запрашивать логин и пароль у пользователя.

-txt - утилита выполнит экспорт/импорт в формате "Personnel TXT"
-xml - утилита выполнит экспорт/импорт в формате "XML"

-export экспортируемый_файл - утилита выполнит экспорт данных в
указанный файл. При необходимости
создания дополнительных файлов
(например, фотографий сотрудников), эти
файлы будут созданы в том же каталоге,
что и указанный файл.

-import импортируемый_файл - утилита выполнит импорт данных из ука-
занного файла. При необходимости чтения
дополнительных файлов (например, фото-
графий сотрудников), эти файлы будут
загружаться из того же каталога, что и
указанный файл, если в именах
дополнительных файлов каталог не указан.

-header "строка_заголовка" - опция, задающая строку заголовка
импортируемых данных в формате
"Personnel TXT".

Если эта опция не указана, то строка
заголовка является первой строкой
входного файла.

Если эта опция указана, то за ней должна
следовать строка заголовка в двойных
кавычках. Первая строка входного файла
будет считаться строкой данных.

-report "параметры отчета" - утилита выполнит формирование отчета и
экспортирует отчет в csv-файл.

После ключа -report в двойных кавычках должна быть указана строка
параметров отчета. Структура этой строки следующая:

"Report=название_отчета;File=имя_файла;Personnel=сотрудник_или_отдел1;Personnel=сотрудник_или_отдел2;...;Period=период;Header=Off"

Строка не должна содержать пробелов, если только эти пробелы не входят
в название отчета, сотрудника, отдела или имени файла.

Строка должна содержать параметры "Report=название_отчета" и
"File=имя_файла". Другие параметры не являются обязательными.

название_отчета - название отчета в "Золотых Воротах".

имя_файла - имя файла, в который будет записан
сформированный отчет в csv-формате

сотрудник_или_отдел1 - название сотрудника или отдела, по которому
формируется отчет.

Если указано несколько параметров
Personnel=сотрудник_или_отдел, то отчет будет
формироваться по указанным сотрудникам или
отделам.

Если указан параметр Personnel=All, то отчет
будет формироваться по всем сотрудникам или
отделам, имеющимся в базе данных "Золотых
Ворот".

период - строка вида yyyy-mm-dd hh:nn:ss..yyyy-mm-dd hh:nn:ss,
задающая дату и время начала и конца отчетного
периода.

Начало и конец разделены двумя подряд идущими
точками (..). Если время опущено, то считается,
что для начала периода задано начало суток
(0:00:00), а для конца периода задано окончание
суток (23:59:59).

Допускается также задавать период в виде даты
без времени. В этом случае будет формироваться
отчет за сутки (0:00:00..23:59:59).

Допускается задание одного из шести периодов
времени, автоматически привязываемого к текущей
дате:
- LastMonth - прошедший месяц
- CurrentMonth - текущий месяц
- LastWeek - прошедшая неделя
- CurrentWeek - текущая неделя
- LastDay или Yesterday - вчера
- CurrentDay или Today - сегодня

Header=Off - параметр для удаления строки заголовка из
выходного файла.

Допускается указание этого параметра в виде:
- Header=False
- Header=Disabled
- Header=0



Предыдущие версии программы обновляются либо установкой нового пакета, либо обновлением исполняемых файлов поверх установленных. Перед какими-либо действиями сильно рекомендую сделать резервную копию директории программы, а так же резервную копию базы утилитой GGBackUp.
Первый вариант у меня перезаписал файлы базы пустыми. Попытка восстановления из предварительно созданной резервной копии базы успехом не увенчалась - сообщалось об ошибках в разных файлах *.mdf. Перезапись файлов данных из предыдущей версии тоже ничего не дал. Хотя, возможно, я не все файлы заменил - с MSSQL не знаком. Возврат старой версии и обновление исполняемых файлов из новой - тщетно.
Помог второй вариант. Support ITVSystems выслали по почте набор новых исполняемых файлов, которые я записал в директорию со старой версией программы, и все заработало. Отдельное им спасибо за оперативность.

Комментариев нет:

Отправить комментарий