Печать твердых копий из OOBase

ООфис  имеет встроенные средства для создания отчетов и они наверное подойдут многим. Но откровенно говоря я склоняюсь к печати документов через программно генерируемые таблицы ООКалк.

Кто еще хочет попробовать вот много кода из которого можно и для себя взять какие-то моменты. Главное собственно вызвать ООКалк с пустым документом, а по прочим вопросам документации достаточно.

Sub PrintNZP()

  MsgBox "Закройте текущее сообщение и дождитесь сообщение <<Обработка документа окончена>>"   

  Dim oNDoc, oNSheets, oNSheet

  oNDoc = StarDesktop.loadComponentFromURL( _
    "private:factory/scalc", "_blank", 0, Array() )
  oNSheets = oNDoc.getSheets()
  oNSheet = oNSheets.getByIndex(0)
 

OOBase Basic

Спасибо за включение ссылки на мои заметки в Вики русскоязычного форума ООо http://wiki.forumooo.ru/wiki/%D0%9F%D0%BE%D0%BB%D0%B5%D0%B7%D0%BD%D1%8B%D0%B5_%D1%81%D1%81%D1%8B%D0%BB%D0%BA%D0%B8 (Сразу замечу, что не имел к этому никакого отношения - просто пытался старательно выполнять свою работу). Понял, что не хватает собственно файла с моими наработками. Вот он с Виртуального Диска Гуугла:
 
https://drive.google.com/file/d/0B1CrvL0JhNFeeFBJWWJ4TGZra1U/view?usp=sharing

OpenOfficeBase + Basic - обещанное продолжение.

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

Во-первых, я стал более ориентироваться на использование в качестве движка OpenOfficrBase (not OpenOfficeWriter). Это произошло в связи с тем, что 3-я версия офиса поддерживает библиотеки уроня файла базы данных, которые могут удобно распрастраняться внутри файла .odb.

Во-вторых, я перешел на использование соединения JDBC, так как "родные" офисные соединения, к сожалению, не всегда поддерживают возможности JDBC 3...4.

В-третьих, я перешел на использование вода через форму (а не прямо в таблице). Это обусловлено и большей наработкой кода, который позволяет мастерить формы без проблем. И, в большей степени, из-за обнаружившегося ограничения ввода связанных данных через список (или комбобокс) примерно 30 тыс. строк (связано с разядностью целого числа).

Теперь немного кода.

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

Sub FromBaseToDialog(oForm, oDialog)
 If oForm.IsNew Or oForm.IsAfterLast() Or oForm.IsBeforeFirst() Then
  Exit Sub
 End If
 Dim I
 Dim sName As String
 For I = 0 To Ubound(oDialog.Model.ElementNames)
  sName = oDialog.Model.ElementNames(I)
  If Mid(sName, 1, 1) <> "_" And Mid(sName, 1, 5) <> "Label" Then
   ODialog.GetControl(sName).SetText(oForm.Columns.GetByName(sName).String)
  End If
  If Mid(sName, 1, 6) = "_date_" Then
   DateFromBaseToControl(oForm.Columns.GetByName(Mid(sName, 7)), ODialog.GetControl(sName))
  End If
  If Mid(sName, 1, 7) = "_combo_"  Then
  'xRay oForm.Columns.GetByName(Mid(sName, 8))
   If oForm.Columns.GetByName(Mid(sName, 8)).String <> "" Then
    InitComboBox(oDialog, sName, oForm.Columns.GetByName(Mid(sName, 8)).String)
   End If
  End If

  
 Next I
End Sub

Sub FromDialogToBase(oDialog, oForm)
 Dim I
 Dim sName As String
 For I = 0 To Ubound(oDialog.Model.ElementNames)
  sName = oDialog.Model.ElementNames(I)
  If Mid(sName, 1, 1) <> "_" And Mid(sName, 1, 5) <> "Label" Then
   If Mid(sName,1,4) = "date" Then
    oForm.Columns.GetByName(sName).UpdateString(ctl.util.Replace(Trim(oDialog.GetControl(sName).GetText()), ",", "."))
   Else
    oForm.Columns.GetByName(sName).UpdateString(Trim(oDialog.GetControl(sName).GetText()))
   End If
  End If
  If Mid(sName, 1, 6) = "_date_" Then
   DateFromControlToBase(ODialog.GetControl(sName), oForm.Columns.GetByName(Mid(sName, 7)))
  ' DateFromBaseToControl(oForm.Columns.GetByName(Mid(sName, 7)), ODialog.GetControl(sName))
  End If
  If Mid(sName, 1, 7) = "_combo_" Then
   oForm.Columns.GetByName(Mid(sName, 8)).UpdateString(ODialog.GetControl(sName).GetModel.Tag)
  ' DateFromBaseToControl(oForm.Columns.GetByName(Mid(sName, 7)), ODialog.GetControl(sName))
  End If
 Next I
End Sub

Как видно, есть специальные имена, начинающиеся с знака подчеркивания. Они подойдут для всяких меток, которые не должны обрабатываться. И еще пока что два обрабатываемых имени _date_ и _combo_, которые обрабатываются специальным образом. О списках  (комбобоксах) ма поговорим в следующий раз, а о датах можно поговорить сейчас. OpenOffice удобно обрабатывает даты вводом через календарь, но что касается перевода БД в строку, присваивания строки элементу и обратно - то тут царит полнй хаос. Для PosgreSQL я использую вспомогательные функции:

Function DateToControl(dt) As Long
 DateToControl = dt.YEAR*10000 + dt.MONTH*100 + dt.DAY
End Function

Sub DateFromBaseToControl(field, ctl)
 If DateToControl(field.DATE) > 0 Then
  ctl.SetDate(DateToControl(field.DATE)
 Else
  ctl.SetText("")
 End If
End Sub

Function DateFromControl(dt As Long) As Object
 Dim oDt As New com.sun.star.util.Date
 Dim NewDate As String
 NewDate = dt
 If dt > 0 Then
  oDt.YEAR = Mid(NewDate,1,4)
  oDt.MONTH = Mid(NewDate,5,2)
  oDt.DAY = Mid(NewDate,7,2)
 End If
 DateFromControl = oDt
End Function

Sub DateFromControlToBase(ctl, field)
 if ctl.GetDate() <> 0 Then
  field.UpdateDate(DateFromControl(ctl.GetDate()))
 else
  field.UpdateNull()
 End If
End Sub

Ну вот собственно и все.

Теперь по кнопке вызываем диалог:

Sub Dogovor_Edit(Event)
 Dim oDialog As Object
 Dim f_dogovor As Object
 f_dogovor = Thiscomponent.DrawPage.Forms.GetByName("f_dogovor")
 oDialog = GetDialog("ctl", "dogovor")
 If oDialog.Execute() = 1 Then
  If Event.Source.Model.Tag = "new" Then
   f_dogovor.MoveToInsertRow()
   ctl.util.FromDialogToBase(oDialog, f_dogovor)
   f_dogovor.InsertRow()
  Else
   ctl.util.FromDialogToBase(oDialog, f_dogovor)
   f_dogovor.UpdateRow()
  EndIf
 Else
 End If
End Sub

Пока.

OpenOffice Base - что же дальше

Я понимаю, что читатель истосковался по более сложному коду. И он скорo будет опубликован. Мое направление сейчас - обернуть функционалом стандартный котнрол Диалогов - ComboBox.

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

Объекты Connection, Statement, ResultSet в OpenOffice

Для решения простых задач достаточно декларативно задать объекты данных в Мастерах-построителях или в Палитрах свойств объектов Формы. Если бы на этом возможности OpenOffice заканчивались, то кроме игр с данными ему сложно было бы найти применение. Вспоминаю сколько раз я раскрывал Star/OpenOffice, создавал подключение к серверу баз данных и с грустью закрывал, полистав весьма скудный (и до сих пор это так) Help.

Но время не стоит на месте. В Интернете начала накапливаться полезная информация о макросах OpenOffice и вот мы здесь.

Для начала работы следует получить объект Connection. Его можно получить несколькими способами. В частности из свойства ActiveConnection объекта Form или по символическому имени DataSource, которое можно задавать из Главного меню|OpenOffice Tools|Options|OpenOffice.org Base|Databases. Если вынести функцию GetConnection в скрипт из раздела My Macros, всегда будет достаточно изменить код ровно в одном месте чтобы измененить подключение.

Function GetConnection() As Variant

  Dim DataSource As Variant

  Dim Connection As Variant

  DatabaseContext = CreateUnoService("com.sun.star.sdb.DatabaseContext")

  DataSource = DatabaseContext.GetByName("sourcename")

  GetConnection = DataSource.GetConnection()

End Function

Получив Connection надо создать Satement или PreparedStatement.

oStatement = GetConnection().CreateStatement

oResultSet = Statement.ExecuteQuery("select * from ...")

lCount = Statement.ExecuteUpdate("update ...")

Теперь особое предупреждение для любителей строить запросы конкатенацией строк. Не забудем, что OpenOffice является офисным приложением. Поэтому при переводе чисел с точкой в строку десятичная точка превращается... превращается ... правильно - в десятичную запятую, что скорее всего откажется воспринять ваш сервер баз данных. Для такого случая удобно воспользоваться параметрическим запросом.

pStatement = GetConnection().PrepareStatement("update ... set ... = ? where ... = ?")

pStatement.SetDouble(1, 123.456)

pStatement.SetString(2, "789" )

                                                    ' pStatement.ExecuteQuery

pStatement.ExecuteUpdate


Объект ResultSet, полученный в результате запроса поддерживает удобную (привычную) навигацию и может быть изменяемым. То есть все плюшки, известные по ODBC/JDBC/DAO/ADO  и иже с ними налицо. Впрочем это все уже можно прочитать в Интернете. Я же хотел дать зацепки для поиска нужных моментов. Пока.

Библиотеки, диалоги и документы Writer при работе с OpenOffice Base

(Важное замечания. В связи с Выходом 3-й версии ООфиса автор изменил точку зрения и применяет библиотеки уровня файла базы данных, которых не было во 2-й версии ООфиса)

Написав первые строчки на OpenOffice Basic опытный программист начинает задумываться а как же рационально организовать программный код. Продукт, который от редактора текста эволюционирует в сторону среды для работы клиентской части приложения, работающего с сервером баз данных, тянет за собой неизбежно длинный "хвост", надеюсь, что дальше будет лучше, но уже и сейчас неплохо.

Начнем собственно с OpenOffice Base. Мы уже отмечали раннее, что Форма открывается как документ Writer  и собственно им и является. Отсюда очевидное решение. Зачем "грузить" многофункциональное IDE Base, если можно сразу разрабатывать Форму в IDE Writer. Результат совершенно аналогичный.

Идем дальше. Программный код хранится во внешних библиотеках, которые представляют собой папку/ каталог на диске и макросах/скриптах, которые представляют собой файл .vba. Внешние скрипты отображаются в разделе  My Macros. Существуют еще и внутренние приватные скрипты, которые хранятся вместе с Формой во внутреннем формате документа Writer. Несмотря на то, что такие скрипты удобно распространять (вместе с файлом), их повторная применяемость исключена,  так как они существуют только внутри Формы/документа Writer.

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

GlobalScope.BasicLibraries.LoadLibrary("LibName")

Теперь процедуры и функции библиотеки становятся доступны в текущем контексте. К ним можно обращаться как SomeFunction() или Libname.SomeFunction(). В последнем случае мы застрахованы от переопределения функций в разных библиотеках.

Все что сказано о макросах верно и для Диалогов (диалоговых окон). Каждый внешний Диалог хранится в библиотеках/папках/каталогах в отдельном файле. Внутренний - во внутреннем формате документа Writer. Диалог это достаточно мощный инструмент. Он может содержать стандартные элементы управления (кнопки, текстовые поля, радиоклавиши, списки, комбинированные поля), Но все эти элементы управления (в отличие от подобных в Формах) не могут иметь декларативной связи с базами данных и должны заполняться данными программно. Зато эти элементы легковесны и модальны. Загружать внешний Диалог нужно явно как показано в тексте функции

Funcion OpenDialog(sLibName, sDialogName)

  GlobalScope.DialogLibraries.LoadLibrary(sLibName)

  oLib = GlobalScope.DialogLibraries.GetByName(sLibName)

  oDialog = oLib.GetByName(sDialogName)

  oDlg = CreateUnoDialog(oDialog)

  oDlg.Execute()

  OpenDialog = oDlg

End Function

Это все, что сегодня я хотел сказать. Пока.

Подчиненные объекты form и списки в OpenOffice как реляцинные таблицы баз данных

Как мы уже уточнили в прошлом сообщении объект form может непосредственно входить в коллекцию forms,  а может быть подчиненным другому объекту form. Для этого открыв Навигатор форм надо выделить существующую form и правая кнопка мыши|new form.

Вспомним, что объект  form является объектом типа ResultSet. Поэтому с каждой form нужно связать существующую таблицу данных, запрос или SQL-запрос. В подчиненной form отражаются данные отфильтрованные по значению связанных полей в основной form по типу Master/Slave. Для этого в редакторе свойств подчиненной формы нужно заполнить свойства link master fields и link slave fields.

ОК. Теперь в каждую из form добавим по элементу Table Control, выбрав соответствующую form в Навигаторе форм. При этом запустится Мастер, с предложением выбрать таблицу данных или запрос, если Вы еще явно не указали его в свойствах объекта form. После этого Мастер предложить выбрать отображаемые поля. Впрочем, этот процесс можно прервать и заполнить данные в визуальном Конструкторе.

Второй тип связи, который мы рассмотрим - связь типа Справочник. Это распространенный случай. Мы храним в таблице данных ключ объекта (GUID, autoincrement и т.п.) а в отображаемой таблице выводим его полное наименование. Для этого есть удобный механизм. В визуальном Конструкторе таблицы выделяем колонку правая кнопка мыши|Replace With|List Box. Далее редактируем список свойств колонки. На закладке data свойству Тype of List Content присваиваем значение SQL. Запрос в свойстве List Content должен в первой колонке содержать отображаемое значение, а свойство Bound Field индекс колонки с ключевым полем (если считать, что первая колонка имеет индекс 0). То есть в подавляющем большинстве запросов это будет 1 для запросов типа

SELECT USERNAME, USERID FROM USERS ORDER BY USERNAME

Еще одна плюшка - накладывать фильтр на таблицу данных можно по значению введенному в текстовое поле. Для этого напишем на языке OO Basic процедуру обрабатывающую событие от клавиатуры.

Sub TextBox_onKeyUp(oEvent)

 

  oDocument = ThisComponent

  oDocument.LockControllers

  sText = oEvent.Source.text

  if Len(sText) > 3 Then

    oForm =  ThisComponent.Drawpage.Forms.getByName("MyForm")

    oForm.Filter = "USERNAME LIKE '" + sText  + "%'"

    oForm.reload()

  End If

  oDocument.UnlockControllers 

End Sub

Свяжем его с событием Key released текстового поля (на закладке event списка свойств). Заметим, что это поле должно быть расположено в другой form, чтобы перезагрузка form не "обнуляло" его текущее значение, введенное с клавиатуры. Пока.

Формы, Forms и Form в OpenOffice Base

С формами в OpenOffice Base произошла некоторая путаница. Я не ошибся в названии. Дело в том, что в процессе эволюции программного обеспечения оказалось, что Формы, Forms и Form - это немного не одно и то же. И Form - это не только Form. Поясню подробнее.

Когда Вы открываете базу данных OpenOffice Base в режиме редактирования, то видите в левой части экрана четыре закладки. В русифицированной версии это будет звучать как

• Таблицы
• Запросы
• Формы
• Отчеты

В этом смысле Форма является некоторым самостоятельным приложением, которое запускается в отдельном окне Windows. Замечу еще, что на самом деле это окно в котором запускается экземпляр OpenOffice Writer (ну и ну!)

OpenOffice Base - подключение к серверу баз данных

В предыдущем сообщении описан процесс установки среды для работы с базами данных - сервер PostgreSQL и пакет OpenOffice версии 2.4.1 или выше. Кроме того описано как установить некоторые плагины/расширения для OpenOffice. Сейчас для нас важно иметь плагин/расширение postgresql-sdbc для прямого доступа к серверу PostgreSQL. Не все релизы плагинов/расширений совместимы с конкретным релизом OpenOffice. О чем могут выдаваться предупреждающе сообщения, а могут и не выдаваться.

Если плагин/расширение установлен правильно, он должен иметь статус Enabled в окне Tolls|Extension Manager, вызываемого из Главного меню OpenOffice. Если это так - подключимся к существующей базе данных PostgreSQL. (Создание баз данных в PostgreSQL выходит за рамки этой серии сообщений, поскольку уже хорошо описано в документации PostgreSQL).

Начинаем работу с OpenOffice Base

Кому предназначен этот пост - прежде всего мне. Если Вы ищете средство для быстрой разработки интерфейса к серверу баз данных, например PostgreSQL - значит, возможно, и Вам.

Для 99% случаев, данные стоит хранить на SQL-сервере, не обязательно MS. Не ввязываясь в полемику какой сервер круче, замечу, что бесплатных и легко администрируемых серверов в настоящее время предостаточно. К известным всем решениям я могу добавить только свеженький Cubrid-сервер.

Сервер баз данных - это, конечно, хорошо. Но на чем писать клиентскую часть? Практически все средства быстрой разработки коммерческие. И даже если это стоит недорого - никто не застрахован от наличия в руководстве зациклившихся на своем Эго субъектов, от которых зависит решение. Мне приходилось слышать разные типы отказов от "то же самое можно сделать и в Excel" до "я Вам напишу это за день на Делфях и оба будем счастливы". И вот по крайней мере с версии 2.0 OpenOffice уже содержит хороший набор средств для быстрой разработки клиентской части баз данных. Эти средства пока мало востребованы. Основная причина, на мой взгляд - отсутствие документации. Прошло 5 лет, вышел очередной релиз - OpenOffice 3, наконец, фрагменты кода стали гулять в Интернете. Вышла подробная книга на английском языке и первая книга на русском о программировании на языке OO Basic для OpenOffice и OpenOffice Base.