Olga Ivolgin has translated Dani Vainstein’s chapter on accessing Adobe Acrobat PDF files into Russian. Here’s the first part of her article:

Просматривая каталлог статей, которые могли бы заинтересовать русскоязычных читателей, я решила остановить свой выбор на этой статье.На мой взгляд именно этот труд, в своё время принес Даниэлю Вайнштейн мировую известность среди пользоватей QTP.

Данная статья будет полезна всем, у кого есть время для своего развития и тем кто как то связан, в первую очеpедь с QTP.

Итак НАЧИНАЕМ…

Что пpедставляет из себя Adobe Acrobat?

Adobe Acrobat – это семейство инструментальных средств, с помощью которых возможно создавать, хранить, отображать и изменять такой надёжный и независимый от операционных сиситем формат файла, как PDF (Portable Document Format).

Помимо Adobe Acrobat существуют и другие форматы электронных изданий, но ни одно из них не является настолько универсальным средством для создания и передачи электронных документов.

Сегодня Adobe Acrobat применяется в трех направлениях:

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

Print – формат для использования на печатных устройствах невысокого разрешения, где важным является возможность печати документа на офисных устройствах. Можно ли этот формат отнести к первой группе? Можно! Но графические файлы будут занимать больше места в самом документе, потому, что их разрешение ориентировано для печатных устройств, а не для разрешения экрана в 72 dpi.

PrePress – эта группа является важна прежде всего для предпечатной подготовки документов. Эта модификация потребуется для вывода пленок на фотонаборных автоматах для последующей печати с них полиграфической продукции.

PDF/X – пока не принятая концепция графического файла для замены существующего формата TIFF. Эта модификация должна заменить (по задумке) формат TIFF, потому как этот формат, явно устарел и не поддерживает современных возможностей. Очень громоздкий по сравнению даже с многослойным PSD (родной формат Adobe Photoshop).

Формат Adobe Acrobat является кроссплатформенным. А это значит, что документ созданный на РС будет читаться на Macintosh, SUN, Sgi и т.д. И плюс еще мобильные устройства разных платформ. В добавок все это прекрасно работает с русским языком .

К примеру , на операционной системе Windows Microsoft Adobe Acrobat и Adobe Reader экспортируют информационное наполнение формата PDF как объекты общей объектной модели. Приложения можно связать с помощью интерфейса с Акробатом или Adobe Reader двумя способами:

1. Через “Активную Доступность” Microsoft (MSAA) интерфейс, используя объекты MSAA, как Акробат или экспорты Adobe Reader.

2. Непосредственно через экспортируемые объекты общей объектной модели, которые позволяют доступ к внутренней структуре документа в формате PDF, названной Объектной Моделью Документов – (DOM).

Как начать автоматизировать проверки PDF файлов ?

Для этого мы обратимся к SDK Акробатa.SDK Акробата – это ряд инструментальных средств, при помощи которых возможно взаимодействовать с технологией Акробата. SDK содержит файловые библиотеки и простые утилиты помогающие разработать программное обеспечение, которое интегрирует с Акробатом и Adobe Reader .С его помощью QTP обращается к IPI PDF, соответственно рассматривая его как объект .

Полную информацию можно получить здесь :

http://www.adobe.com/devnet/acrobat/,

http://www.adobe.com/devnet/acrobat/?tab:downloads=1 ,

Com-библиотека : http://program.rin.ru/razdel/html/464.html ,

http://www.adobe.com/devnet/acrobat/pdfs/iac_api_reference.pdf

Обязательным условием так же является инсталяция полной версии Adobe Acrobat, иначе во время запуска кода, будет выскакивать сообщение об ошибке такого типа :

В дальнейшем, все примеры задач будут использовать файл QTTutorial.pdf . (Обучающая программа QuickTest pdf Файл)

Сам файл расположен в инсталляционной Папке/help/QTTutorial.pdf .

OLE Automation Objects

Эта глава описывает объекты, типы данных и методы в интерфейсе автоматизации OLE.

Названия AcroExch. Приложение AxAcroPDFLib. AxAcroPDF – внешнее использование OLE-КЛИЕНТОВ строк, чтобы создать объекты определенных типов. Библиотеки типа разработчика Акробата называют их CAcro. Приложение и AcroPDFLib, соответственно.

Акробат поддерживает двойные интерфейсы, таким образом методы у всех есть тип возвращения HResult.

Данная программа динамически открывает файл Acrobata :

Option Explicit

Dim gApp, gPDDoc, jso

Set gApp = CreateObject( "AcroExch.App" )

Set gPDDoc = CreateObject( "AcroExch.PDDoc" )

If gPDDoc.Open( "c:\MyPdfFile.pdf" ) Then

    Set jso = gPDDoc.GetJSObject()

    jso.console.Show

    jso.console.Clear

    jso.console.println ( "Hello, Acrobat for QuickTest!" )

    gApp.Show

End If

Set jso = Nothing

Set gPDDoc = Nothing

Set gApp = Nothing

AcroExch.Point Object

Этим способом можно получить “размерность” страницы.

SetCArcoPoint = PDPage.GetSize()

С помощью AcroExch.Point.XProperty можно получить или устанавить x / y -координаты AcroPoint .

AcroExch.Rect Object

Этим способом можно определить  координаты верней левой и правой нижней части документа.

AcroExch.Rect.Left Property

AcroExch.Rect.Right Property

AcroExch.Rect.Top Property

Этим способом можно выбрать текст исходя из размера страницы :

Set PdPage = PDDoc.AcquirePage(0)

Set CArcoPoint =  PDPage.GetSize()

CAcroRect.Top = CArcoPoint.Y

CAcroRect.Left = 0

CAcroRect.Right = CArcoPoint.X

CAcroRect.bottom = 0