Параметри командного рядка

Нижче описано ключі та параметри командного рядка Reportizer Viewer. Ви можете передавати ці параметри при запуску Reportizer Viewer з .bat файлів, ярликів, а також при викликах Reportizer Viewer із ваших власних програм.

Ключі та параметри в квадратних дужках [] є необов'язковими, в трикутних дужках <> - обов'язковими.

Увага!

1. Ключі та параметри командного рядка мають більший пріоритет, ніж відповідні налаштування самого звіту.
2. Ключі та параметри командного рядка, як правило, діють лише на той звіт або звіти, що вказані в командному рядку. Якщо обробки командного рядка користувач, не закривши програму, відкриває інший звіт, то на нього ключі та параметри командного рядка розповсюджуватися не будуть.
3. Рекомендується використовувати повні імена файлів в усіх параметрах, в яких задіяно імена файлів.
4. Якщо значення якогось параметру командного рядка містить лапки, потрібно замінити їх комбінацією &quot;.
5. У випадку задубльованих параметрів буде використовуватися значення із останнього параметра.

Специфікація

rptview.exe  [/ActionFile=<назва файлу для параметрів командного рядка>]  [/PrinterSetup]  [/PrintFolder]  [/DisableOpening]  [/DisableExporting]  [/DisableEditing]  [/PrinterName=<назва принтера>]  [/PaperSize=<розмір паперу>]  [/PaperSource=<джерело паперу>]  [/DuplexMode=<режим дуплексу>]  [/print]  [/PrintToFile=<назва файлу>]  [/copies=<кількість копій>]  [/pages=<сторінки для друку>]  [/collate]  [/StretchPrint]  [/minimize]  [/CloseWhenDone]  [/ChangeDB=<база даних>]  [/ChangeDBServer=<назва або IP-адреса серверу>]  [/ChangeDBPort=<порт>]  [/UserName=<ім'я користувача>]  [/Password=<пароль для входу в базу даних>]  [/ExportToFile=<назва файлу для експорту>]  [/ExportFormat=<формат експорту>]  [/ExportSeparatePages]  [/ExportGrayScale]  [/ExportPageStart=<номер початкової сторінки для експорту>]  [/ExportPageEnd=<номер кінцевої сторінки для експорту>]  [/ExportEncoding=<кодування експорту>]  [/ExportTextSeparator=<розділювач полів>]  [/ExportDocTitle=<заголовок цільового документа>]  [/ExportAuthor=<автор цільового документа>]  [/ExportLineSeparator=<розділювач рядків>]  [/ExportHorzCellDiff=<гор. інтервал між об'єктами>]  [/ExportVertCellDiff=<верт. інтервал між об'єктами>]  [/ExportLayout=<тип розкладки документу>]  [/ExportTargetImageFormat=<цільовий формат картинок>]  [/SQLParamNames=ParamName1%#%ParamName2%#%...]  [/SQLParamValues=ParamValue1%#%ParamValue2%#%...]  [/SQLParamTypes=ParamType1%#%ParamType2%#%...]  [/SQLMacroNames=MacroName1%#%MacroName2%#%...]  [/SQLMacroValues=MacroValue1%#%MacroValue2%#%...]  [/VarNames=VariableName1%#%VariableName2%#%...]  [/VarValues=VariableValue1%#%VariableValue2%#%...]  [/StaticPassword=<пароль для статичного звіту>]  <файл звіту|тека, з якої відобразити список файлів>

Загальні опції

/ActionFile=<назва файлу для параметрів командного рядка>

Вказує назву для файла операцій. Файл операцій - це текстовий файл, що містить набір параметрів командного рядка, у форматі один параметр на рядок. Рядки, що починаються на крапку з комою, вважаються коментарем і ігноруються програмою. Допускаються пусті рядки. Такі файли можуть мати будь-яке розширення. Кодування файлу повинно бути ANSI або UTF-8 з BOM. Можна частину параметрів поміщати до файлу, а іншу частину ззовні; при дублюванні параметрів більший пріоритет мають ті параметри, що знаходяться не у файлі. Див. приклади нижче.

/PrinterSetup

Вказує, що перед відкриттям головного вікна програми повинен бути показаний діалог налаштувань принтера.

/PrintFolder

Вказує, що програма повиннна вивести список файлів з теки, заданої параметром файл звіту|тека, з якої відобразити список файлів.

/DisableOpening

Блокує кнопку Відкрити.

/DisableExporting

Блокує кнопку Експортувати звіт.

/DisableEditing

Блокує кнопку Редагувати шаблон звіту.

/PrinterName=<назва принтера>

Вказує принтер, на який потрібно направити друк. Якщо не вказаний, то буде використовуватися принтер, збережений в самому звіті, при умові, що властивість Вибирати принтер встановлена на Так; інакше буде використовуватися поточний принтер.

/PaperSize=<розмір паперу>

Вказує розмір паперу для принтера (наприклад, A5, A4 і т.д.). Якщо не вказаний, то буде використовуватися розмір, збережений у властивостях сторінки в самому звіті; якщо ж і там розмір не вказаний, використовуються поточні налаштування принтера.

/PaperSource=<джерело паперу>

Вказує джерело паперу для принтера. Якщо не вказаний, то буде використовуватися джерело, збережене в самому звіті; якщо ж і там джерело не вказане, використовуються поточні налаштування принтера.

/DuplexMode=<режим дуплексу>

Вказує режим дуплексу для принтера, що підтримує дуплексний друк. Можливі значення: SIMPLEX, HORZ або HORIZONTAL, VERT або VERTICAL. Якщо не вказаний, то буде використовуватися режим, збережений в самому звіті.

/minimize

Програма запускається в мінімізованому режимі. Вона повертається до нормального режиму при помилці або після закінчення виконання дій, передбачених в командному рядку (якщо ключ /CloseWhenDone не використовується).

/CloseWhenDone

Вказує, що програма повинна бути автоматично закрита після виконання задачі (тобто після друку чи експорту звіту). Цей ключ вживається з ключем /print або /ExportToFile.

/StaticPassword=<пароль для статичного звіту>

Вказує пароль для захищеного паролем статичного звіту.

файл звіту|тека, з якої друкувати список файлів

Повна назва файлу звіту (динамічного або статичного) або теки, з якої потрібно друкувати список файлів (якщо задіяно ключ /PrintFolder). Обов'язковий параметр. Якщо ця назва містить пробіли, повинен братися в лапки.

/VarNames=VariableName1%#%VariableName2%#%...

Список глобальних змінних звіту, чиї початкові значення повинні бути перезаписані. Якщо в списку більше одного елемента, то їх потрібно розділяти комбінацією символів %#%. Якщо параметр містить пробіли, він повинен братися в лапки. Цей параметр повинен використовуватися разом з ключем /Preview або /Print. Див. приклади нижче.

/VarValues=VariableValue1%#%VariableValue2%#%...

Список початкових значень для глобальних змінних звіту. Якщо в списку більше одного елемента, то їх потрібно розділяти комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /VarNames. Якщо параметр містить пробіли, він повинен братися в лапки.

Опції, пов'язані з базою даних звіту

/ChangeDB=<база даних>

Дозволяє динамічно підмінити опцію База даних в налаштування бази даних звіту. Інші опції в налаштування бази даних звіту не змінюються. Якщо містить пробіли, весь параметр повинен братися в лапки.

/ChangeDBServer=<назва або IP-адреса серверу>

Дозволяє динамічно підмінити опцію Сервер в налаштування бази даних звіту. Інші опції в налаштування бази даних звіту не змінюються. Якщо містить пробіли, весь параметр повинен братися в лапки.

/ChangeDBPort=<порт>

Дозволяє динамічно підмінити опцію Порт в налаштування бази даних звіту. Інші опції в налаштування бази даних звіту не змінюються.

/UserName=<ім'я користувача>

Вказує ім'я користувача бази даних звіту (якщо вона захищена паролем і це ім'я не вказано в самому шаблоні). Якщо містить пробіли, весь параметр повинен братися в лапки.

/Password=<пароль для входу в базу даних>

Вказує пароль бази даних звіту (якщо вона захищена паролем і пароль не вказано в самому шаблоні). Якщо містить пробіли, весь параметр повинен братися в лапки.

/SQLParamNames=ParamName1%#%ParamName2%#%...

Може використовуватися у випадках, коли текст SQL звіту є параметризованим запитом SQL. Текст SQL параметризованого запиту містить параметри для динамічної підстановки; кожен параметр починається з двокрапки, наприклад, :ITEMID, :PAYDATE і т.д. Обробка параметрів здійснюється на рівні движка бази даних або на рівні бази даних (для серверних баз даних). Використовуйте цей параметр для вказання списку імен параметрів SQL, які повинні бути автоматично замінені перед виконанням запиту. Цей список має складатися з імен параметрів (двокрапка тут повинна бути опущена), розділених комбінацією символів %#%. Якщо параметр містить пробіли, він повинен братися в лапки. Цей параметр повинен використовуватися разом з параметрами /SQLParamValues та /SQLParamTypes. Див. приклади нижче.

/SQLParamValues=ParamValue1%#%ParamValue2%#%...

Список значень параметрів SQL, розділених комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /SQLParamNames. Для передачі значення null value потрібно писати NULL (у верхньому регістрі). Якщо параметр містить пробіли, він повинен братися в лапки.

/SQLParamTypes=ParamType1%#%ParamType2%#%...

Список типів параметрів SQL, розділених комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /SQLParamNames. Допустимі типи: Boolean, Currency, Date, DateTime, Float, Integer, SmallInt, String, Time, Word. Параметр не повинен містити пробілів.

/SQLMacroNames=MacroName1%#%MacroName2%#%...

Може використовуватися у випадках, коли текст SQL звіту є запитом SQL з макросами. Текст SQL таких запитів містить макроси для динамічної підстановки; кожен макрос починається з << і закінчується на >>, наприклад, <<ITEMID>>, <<PAYDATE>> і т.д.; на відміну від параметрів, макрос не має типу і завжди вставляється як текст. Використовуйте цей параметр для вказання списку імен макросів, які повинні бути автоматично замінені перед виконанням запиту. Цей список повинен містити список імен макросів (розділювачі << та >> тут повинні бути опущені; імена макросів мають складатися лише з букв та цифр), розділених комбінацією символів %#%. Макроси обробляються перед обробкою параметрів SQL, тому можна використовувати макроси всередині параметрів SQL. Якщо параметр містить пробіли, він повинен братися в лапки. Цей параметр повинен використовуватися разом з параметром /SQLMacroValues. Див. приклади нижче.

/SQLMacroValues=MacroValue1%#%MacroValue2%#%...

Список значень макросів SQL, розділених комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /SQLMacroNames. Якщо параметр містить пробіли, він повинен братися в лапки.

Опції друку звіту

/print

Вказує, що звіт повинен бути автоматично надрукований.

/PrintToFile=<назва файлу>

Вказує назву файлу, до якого буде спрямовано принтерний вивід. Може бути зручним при друку з використанням принтера PDF. Цей ключ вживається з ключем /print switch.

/copies=<кількість копій>

Вказує кількість копій, що необхідно надрукувати (наприклад, /copies=4). Якщо не вказаний, використовуються налаштування звіту. Цей ключ вживається з ключем /print.

/pages=<сторінки для друку>

Вказує сторінки, що необхідно надрукувати. Це розділений комами список номерів сторінок або діапазонів номерів сторінок (наприклад, "/pages=1,2,10-24,37"). Якщо не вказаний, друкуються всі сторінки. Цей ключ вживається з ключем /print.

/collate

Вказує, що в разі друку більше, ніж однієї копії, сторінки повинні бути впорядковані по копіях. Якщо не вказаний, використовуються налаштування звіту. Цей ключ вживається з ключем /print.

/StretchPrint

Вказує, що звіт повинен бути надрукований в режимі знімок з екрану. Якщо не вказаний, звіт друкується в режимі прямого друку. Цей ключ вживається з ключем /print.

Опції експорту звітів

/ExportToFile=<назва файлу для експорту>

Вказує назву файлу, в який слід експортувати звіт.

/ExportFormat=<формат експорту>

Вказує формат експорту. Можливі значення: STATIC, HTML, XLSX, XLS, PDF, TEXT, BITMAP, PNG, JPEG, GIF або METAFILE. Якщо цей ключ опущено, формат визначається по розширенню файла з ключа /ExportToFile. Значення по замовчанню: TEXT. Цей ключ вживається з ключем /ExportToFile.

/ExportSeparatePages

Вказує, що при експорті в цільовому файлі потрібно розділяти сторінки (крім STATIC та PDF). Для графічних форматів сторінки розділяються темною рискою. Для форматів HTML, XLSX, XLS, TEXT це працює інакше: розділення відбувається за рахунок експорту секцій Заголовок сторінки, Підвал сторінки, та Заголовки стовпчиків; при відсутності даного ключа перші дві з цих секцій не експортуються, а секція Заголовки стовпчиків присутня лише на першій сторінці.Цей ключ вживається з ключем /ExportToFile.

/ExportGrayScale

Вказує, що при експорті потрібно конвертувати графіку у відтінки сірого. Вживається лише для графічних форматів. Цей ключ вживається з ключем /ExportToFile.

/ExportPageStart=<номер початкової сторінки для експорту>

Вказує номер сторінки звіту, від якої потрібно починати експорт в файл. Цей ключ вживається з ключем /ExportToFile.

/ExportPageEnd=<номер кінцевої сторінки для експорту>

Вказує номер сторінки, на якій потрібно закінчити експорт в файл. Цей ключ вживається з ключем /ExportToFile.

/ExportEncoding=<кодування експорту>

Вказує кодування символів при експорті в файл, наприклад, Windows-1251, UTF-8, ASCII і т.д. Вживається лише для формату HTML. Цей ключ вживається з ключем /ExportToFile.

/ExportLayout=<тип розкладки документу>

Вказує тип розкладки для цільового документу. Вживається лише для формату HTML. Можливі значення: DIVISIONS (об'єкти звіту записуються як теги HTML DIV) або TABLE (об'єкти звіту записуються як тег HTML TABLE). Цей ключ вживається з ключем /ExportToFile.

/ExportTargetImageFormat=<цільовий формат картинок>

Вказує формат для цільових картинок. Вживається лише для формату HTML. Можливі значення: PNG або JPEG. Цей ключ вживається з ключем /ExportToFile.

/ExportTextSeparator=<розділювач полів>

Вказує розділювач полів при експорті в файл. Вживається лише для формату TEXT. Має бути 1 символ, наприклад, крапка з комою (;). Спеціальні символи типу пробілу або символу табуляції повинні бути вказані в наступному форматі: #32 для пробілу, #9 символу табуляції і т.д. Значення по замовчанню: #9. Цей ключ вживається з ключем /ExportToFile.

/ExportLineSeparator=<розділювач рядків>

Вказує стиль завершення рядка в файлі експорту. Вживається лише для форматів TEXT і HTML. Можливі значення: WINDOWS або UNIX. Значення по замовчанню: WINDOWS. Цей ключ вживається з ключем /ExportToFile.

/ExportDocTitle=<заголовок цільового документа>

Вказує заголовок цільового документа для форматів HTML та PDF. Якщо не вказаний, використовується властивість Заголовок документа об'єкта Звіт.

/ExportAuthor=<автор цільового документа>

Вказує автора цільового документа для формату PDF. Якщо не вказаний, використовується властивість Автор об'єкта Звіт.

/ExportHorzCellDiff=<гор. інтервал між об'єктами>

Різниця в пікселях по горизонталі між клітинками віртуальної таблиці, на якій базується вивід. Вживається лише для форматів TEXT, HTML і EXCEL. Значення по замовчанню: 12. Цей ключ вживається з ключем /ExportToFile.

/ExportVertCellDiff=<верт. інтервал між об'єктами>

Різниця в пікселях по вертикалі між клітинками віртуальної таблиці, на якій базується вивід. Вживається лише для форматів TEXT, HTML і EXCEL. Значення по замовчанню: 8. Цей ключ вживається з ключем /ExportToFile.

Приклади командних рядків

rptview.exe c:\MyReport.dtt

rptview.exe c:\MyReport.stt

rptview.exe "c:\My Documents\NewReport.dtt" /print /collate /copies=4 "/papersource=Tray 4" /closewhendone

rptview.exe "c:\My Documents\NewReport.dtt" /username=SYS /password=dio

rptview.exe "c:\report1.dtt" /SQLParamNames=PayerNo%#%PaymentDate /SQLParamTypes=Integer%#%Date "/SQLParamValues=345%#%10/10/2006"

rptview.exe "c:\payment.dtt" "/SQLMacroNames=PayerNumbers" "/SQLMacroValues=1025, 1037, 104"

rptview.exe "c:\payment.dtt" "/VarNames=OBJCOUNT%#%ANCHOR" "/VarValues=0%#%Today"

rptview.exe /PrintFolder /PrinterSetup c:\MyData

rptview.exe "c:\My Documents\NewReport.dtt" /ExportToFile=c:\export.htm /ExportFormat=HTML /PrinterSetup /CloseWhenDone

rptview.exe "/ActionFile=c:\My Documents\ReportAction.txt" /CloseWhenDone