Difference between revisions of "RU/development/qa/vcltesttool/introduction"

From Wiki
Jump to navigationJump to search
(Основной текст статьи)
 
 
(88 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{VCLTesttool/VCLTesttoolTOC
+
<section begin=title /><noinclude>{{DISPLAYTITLE:Контроль качества: </noinclude>Введение для начинающих пользователей<noinclude>}}</noinclude><section end=title />{{BreadCrumbL10n}}
|ShowPrevNext=none
+
 
|ShowPrevPage=none
+
{{RU/vcltesttool/vcltesttooltoc
|ShowNextPage=VCLTesttool/Developer
+
|ShowPrevNext=block
|NextPage=VCLTesttool/Developer
+
|ShowPrevPage=block
 +
|PrevPage=RU/development/qa/vcltesttool
 +
|NextPage=RU/development/qa/vcltesttool/developer
 
|ShowNextPart=none
 
|ShowNextPart=none
 
|ShowPrevPart=none
 
|ShowPrevPart=none
 
}}
 
}}
=Tool for Automated Testing of OpenOffice.org=
+
=Инструментарий для автоматического тестирования OpenOffice.org=
= About the TestTool =
+
= О TestTool =
The TestTool is a program that is used for the automated testing of OpenOffice.org. The TestTool communicates with the TCP/IP-Interface of OpenOffice.org and can test each installation of OpenOffice.org on a PC. The current TestTool can be used on OpenOffice.org 3.0 and higher. However, as there can be some incompatible changes in future OpenOffice.org builds you may need to use a newer version of the TestTool.
+
'''TestTool''' - это программа, предназначенная для автоматизированного тестирования {{OOo}}. TestTool взаимодействует через TCP/IP-интерфейс с {{OOo}} и выполняет тестирование установленного на PC {{OOo}}. Текущая версия TestTool предназначена для работы с OpenOffice.org 3.0 и выше. Однако, в будущем в {{OOo}} могут быть внесены несовместимые изменения и потребуется обновить версию TestTool.
  
The TestTool communicates with OpenOffice.org using SlotIDs, UniqueIDs, and HelpIDs that are associated with each menu item, window, dialog, and window or dialog control in OpenOffice.org. The IDs are automatically generated during the OpenOffice.org build-process or are assigned by developers.
+
TestTool связывается с {{OOo}}, используя SlotIDs, UniqueIDs, и HelpIDs для управления каждым пунктом меню, окнами, диалогами, и диалоговыми параметрами в {{OOo}}. Идентификаторы генерируются автоматически в {{OOo}} построителями процессов или назначаются разработчиками.
  
  
 
{| class="prettytable"
 
{| class="prettytable"
| '''SlotIDs:''' Each menu item has a SlotID that is used, for example, to open a dialog or perform an action.
+
| '''SlotIDs'''
 +
|Каждый пункт меню имеет SlotID который используется, например, чтобы открыть диалог или совершить действие.
  
 
|-
 
|-
| '''HelpIDs:''' Each control, window, or dialog automatically receives a HelpID for the internal Help-System. The TestTool uses HelpIDs to identify specific controls, windows, or dialogs.
+
| '''HelpIDs'''
 +
|Каждый элемент управления, окно или диалог автоматически получает HelpID для внутренней справочной системы. TestTool использует HelpIDs для идентификации конкретного элемента управления, окна или диалога.
  
 
|-
 
|-
| '''UniqueIDs''': A developer can assign a UniqueID to a control that does not have a HelpID so that the TestTool can identify the control.
+
| '''UniqueIDs'''
 +
|Разработчики могут назначать UniqueID элементам управления, которые не имеют собственного HelpID, чтобы TestTool мог идентифицировать данный контрол.
  
 
|}
 
|}
You can create test scripts for the TestTool in the programing language StarBasic (like VisualBasic). Several commands are available for the TestTool, for example, to get or put information into OpenOffice.org controls. For a complete list of the available commands, see: [[VCLTesttool/API_reference|Internal Commands, Methods and Functions for TestTool]].You can simulate most mouse or keyboard actions with the TestTool as well as gather information from controls or change the default settings in OpenOffice.org. In other words, the TestTool lets you simulate an OpenOffice.org user.
 
  
= Location of the TestTool =
 
The ''TestTool Environment'' can be checked out via [[Mercurial/Getting_Started#Creating_a_local_copy|Mercurial]] on openoffice.org,
 
and will be found in the directory: testautomation;
 
Or it is available as a seperate package at: http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/
 
  
The ''TestTool'' application is available at http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html ; On other platforms in the installation set (see setup). Just use the binary from the .''../{officepath}/program''-directory. Start the program t''esttool.bin'' respectively ''testtool.exe''. Just for Mac OS X: Copy the script ''soffice'' to ''testtool'' and run it.
+
Вы можете создать скрипт теста для TestTool на языке программирования StarBasic (подобный VisualBasic). Некоторые команды доступны для TestTool, например, получить или разместить информацию в элементе управления {{OOo}}. Есть [[VCLTesttool/API_reference|полный список доступных команд, описывающий внутренние команды, методы, и функции TestTool [en]]]. Вы можете симулировать большинство действий мыши и клавиатуры из TestTool, а так же собирать информацию из элементов управления или изменять установки по умолчанию в {{OOo}}. Иными словами, TestTool позволяет симулировать поведение пользователя {{OOo}}.
  
= Installing the TestTool =
+
= Расположение TestTool =
To install the TestTool, extract the contents of the downloaded TestTool archive to your local disk. If more than one user will use the TestTool, copy the contents of the extracted archive to a network drive.  
+
''Окружающая среда TestTool'' может быть проверена на [[Mercurial/Getting_Started#Creating_a_local_copy|Mercurial]] в openoffice.org,
 +
и находится в каталоге: '''testautomation''';
 +
Или она доступна в [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ виде отдельно пакета].
  
When you run the TestTool executable file, the testtool.ini and .testtoolrc control files are created on Win32 and UNIX, respectively.
+
Приложение ''TestTool'' [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html всегда доступно для загрузки].
 +
Для других платформ установка так же доступна. Просто используйте двоичный файл из каталога
 +
.../{officepath}/program.
  
If you place a TestTool control file in the directory that contains the TestTool executable file, the control file is automatically copied to the ''profile'' directory on Win32, and the user's ''home'' directory on UNIX.
+
Запустите программу
 +
{{DocLinux| '''testtool.bin'''}}
 +
или
 +
{{DocWindows| '''testtool.exe'''}}
 +
или
 +
{{DocOSX | скопируйте скрипт ''soffice'' в ''testtool'' и запустите его.}}
  
'''Linux only''': If you get a message similar to "Couldn't bootstrap uno servicemanager for reason : Couldn't create registry file ...services.rdb for writing", ensure that you are using 'nfslock'. For example, on Linux run '''/etc/init.d/nfslock status'''''.'' If it is not running, switch to root and run '/etc/init.d/nfslock start' and 'chkconfig nfslock on'. This is necessary for the TurboLinux and the SuSe 8.1 Linux distributions.
+
= Установка TestTool =
  
= Setting up the TestTool =
+
Для установки TestTool, распакуйсте содержимое загруженного архива TestTool на локальный диск. Если TestTool планируют использовать несколько пользователей, скопируйте распакованный архив на сетевой диск.
Choose '''Extra''' - '''Settings''' - '''Profile'''.
 
  
 +
После запуска TestTool выполняет файл настроек
 +
{{DocLinux| '''.testtoolrc'''}}
 +
или
 +
{{DocWindows| '''testtool.ini'''}}
  
{| class="prettytable"
+
Если ваш файл настроек TestTool расположен в том же каталоге, что и исполняемые файлы TestTool, то он автоматически буде скопирован в каталог
! [[Image: Testtool-option-profile.jpg]]
+
{{DocLinux| ''home''}}
 +
или
 +
{{DocWindows| ''профиль''}}
  
|-
 
|
 
# '''''Profile:''' ''Enter a name for your profile.
 
# '''''Log base directory''''': Enter the path where you want to save the test results.For example: ''/opt/qa/qatesttool/errorlog/mymachine'' or ''d:\qa\qatesttool\errorlog\mymachine''
 
# '''''Base directory''''': Enter the ''root path'' for the ''TestTool Environment'' ('''without a slash at the end!''')For example: ''/opt/qa/qatesttool'' or ''d:\qa\qatesttool''
 
# '''''Default HID directory''''': Mark the checkbox.
 
  
 +
{{DocLinux| '''Только для Linux''': Если вы получили сообщение, аналогичное этому:<br>
 +
"''Couldn't bootstrap uno servicemanager for reason : Couldn't create registry file ...services.rdb for writing"'',<br>
 +
убедитесь, что вы используете '''nfslock'''.<br>
 +
Например, в Linux запустите<br>
 +
'''/etc/init.d/nfslock status'''<br>
 +
Если команда не выполняется, то измените от имени root и выполните<br>
 +
'''/etc/init.d/nfslock start'''
 +
и<br>
 +
'''chkconfig nfslock on'''.<br>
 +
Это необходимо для дистрибутивов '''TurboLinux''' и '''SuSe 8.1'''.}}
  
 +
= Настройка TestTool =
 +
Выберите {{Menu|Extra|Settings|Profile}}.
  
|}
+
{| class="prettytable"
If you want, you can also edit these settings in the .testtoolrc / testtool.ini files.
+
!colspan="2" | [[Image: Testtool-option-profile.jpg]]
 
+
|-
'''CurrentProfile'''<nowiki>=_profile_Default</nowiki>
+
|1. '''Profile:'''
 
+
|Введите название вашего профиля.
(...)
+
|-
 +
|2. '''Log base directory''':
 +
|Введите путь, куда будут сохраняться результаты тестов.<br>Например:<br>
 +
{{DocLinux|/opt/qa/qatesttool/errorlog/mymachine}}
 +
или
 +
{{DocWindows|d:\qa\qatesttool\errorlog\mymachine}}
 +
|-
 +
|3. '''Base directory''':
 +
|Введите полный путь к ''Окружению TestTool'' ('''БЕЗ завершающего слэша!'''). <br>Например:<br>
 +
{{DocLinux| '''/opt/qa/qatesttool'''}}
 +
или
 +
{{DocWindows| '''d:\qa\qatesttool'''}}
 +
|-
 +
|4. '''Default HID directory''':
 +
|Отметьте данный флажок.
 +
|}
  
<nowiki>[_profile_Default]</nowiki>
 
  
'''LogBaseDir'''<nowiki>=/opt/qa/qatesttool/errorlog/mymachine</nowiki>
+
При необходимости можно изменить эти настройки в соответствующем конфигурационном файле
 +
{{DocLinux| '''.testtoolrc'''}}
 +
{{DocWindows| '''testtool.ini'''}}
  
'''BaseDir'''<nowiki>=/opt/qa/qatesttool</nowiki>
 
  
'''HIDDir'''<nowiki>=/opt/qa/qatesttool/global/hid</nowiki>
+
'''CurrentProfile'''<nowiki>=_profile_Default</nowiki>
 +
(...)
 +
<nowiki>[_profile_Default]</nowiki>
 +
'''LogBaseDir'''<nowiki>=/opt/qa/qatesttool/errorlog/mymachine</nowiki>
 +
'''BaseDir'''<nowiki>=/opt/qa/qatesttool</nowiki>
 +
'''HIDDir'''<nowiki>=/opt/qa/qatesttool/global/hid</nowiki>
  
= Automated Crashreports =
+
= Автоматизированные креш-отчёты =
: Choose '''Extra''' - '''Settings''' - '''Crashreport.'''
+
: Выберите меню {{Menu|Extra|Settings|Crashreport}}.
  
  
 
{| class="prettytable"
 
{| class="prettytable"
! [[Image: Testtool-option-crashreport.jpg]]
+
|colspan="2" | <center>[[Image: Testtool-option-crashreport.jpg]]</center>
 
+
|-
|-
+
|1. '''Use Proxy'''
|  
+
|Выберите, если доступ в интернет осуществляется через прокси.
# '''''Use Proxy:''''' Check if you need to use a proxy to access the internet.
+
|-
# '''''Host''''': Address of the proy.For example: ''proxy.somewhere.de''
+
|2. '''Host'''
# '''''Port''''': Enter the port number of the proxy.For example: ''8080''
+
|Адрес прокси. Например:
# '''''Allow Contact''''': Mark the checkbox if you want to get an Email regarding your crashreport.
+
''proxy.somewhere.de''
# '''''Email''''': Your Email address.For example: ''you@somewhere.de''
+
|-
 +
|3. '''Port'''
 +
|Введите номер порта прокси. Например:
 +
''8080''
 +
|-
 +
|4. '''Allow Contact'''
 +
|Отметьте этот флажок, если вы разрешите отправлять вам письма касательно ваших креш-отчётов.
 +
|-
 +
|5. '''Email'''
 +
|Адрес вашей электропочты. Например:
 +
''you@somewhere.de''
 +
|}
  
  
 +
В последствии можно отредактировать все эти параметры в конфигурационных файлах
 +
{{DocLinux| '''.testtoolrc'''}}
 +
{{DocWindows| '''testtool.ini'''}}
  
|}
 
: If you want, you can also edit these settings in the .testtoolrc / testtool.ini files.
 
:
 
  
: <nowiki>[</nowiki>Crashreporter]
+
<nowiki>[</nowiki>Crashreporter]
:'''UseProxy'''<nowiki>=true</nowiki>
+
'''UseProxy'''<nowiki>=true</nowiki>
:'''ProxyServer'''<nowiki>=proxy.somewhere.de</nowiki>
+
'''ProxyServer'''<nowiki>=proxy.somewhere.de</nowiki>
:'''ProxyPort'''<nowiki>=8080</nowiki>
+
'''ProxyPort'''<nowiki>=8080</nowiki>
:'''AllowContact'''<nowiki>=true</nowiki>
+
'''AllowContact'''<nowiki>=true</nowiki>
:'''ReturnAddress'''<nowiki>=you@somewhere.de</nowiki>
+
'''ReturnAddress'''<nowiki>=you@somewhere.de</nowiki>
  
= Selecting the OpenOffice.org Installation =
+
= Выбор установки OpenOffice.org =
There are two choices:
 
  
Choose '''Extra''' - '''Settings''' - '''Misc.'''
+
Есть два варианта:
  
 +
Выберите меню {{Menu|Extra|Settings|Misc}}.
  
 
{| class="prettytable"
 
{| class="prettytable"
| <center>[[Image: Testtool-option-misc.jpg]] </center>
+
|colspan="2" | <center>[[Image: Testtool-option-misc.jpg]] </center>
 
+
|-
# '''''OOo Program Dir:''' ''Select the OpenOffice.org installation to test.For example: ''/Volumes/OpenOffice.org 2.0.app/Contents/MacOS ''
+
|1. '''OOo Program Dir'''
 
+
|Выберите установку OpenOffice.org, предназначенного для тестирования. Например:
 
+
/Volumes/OpenOffice.org 2.0.app/Contents/MacOS
 
+
|}
|}
 
 
 
  
If you want, you can also edit these settings in the .testtoolrc / testtool.ini files.
 
  
<nowiki>[</nowiki>OOoProgramDir]
+
В последствии можно отредактировать все эти параметры в конфигурационных файлах
 +
{{DocLinux| '''.testtoolrc'''}}
 +
{{DocWindows| '''testtool.ini'''}}
  
'''Type'''=Path
+
<nowiki>[</nowiki>OOoProgramDir]
 +
'''Type'''=Path
 +
'''Current'''=/Volumes/OpenOffice.org 2.0.app/Contents/MacOS
 +
'''All'''=/Volumes/OpenOffice.org 2.0.app/Contents/MacOS
  
'''Current'''=/Volumes/OpenOffice.org 2.0.app/Contents/MacOS
+
= Редактор TestTool =
 +
TestTool использует подсветку синтаксиса для всего BASIC, StarBasic, и внутренних комманд TestTool. Подробная информация описана в разделе [[VCLTesttool/API_reference|Внутренние команды, методы и функции TestTool [en]]]. Подсветка может увеличивать время загрузки больших файлов.
  
'''All'''=/Volumes/OpenOffice.org 2.0.app/Contents/MacOS
+
= Запуск скрипта TestTool =
 
+
Для запуска установленного OpenOffice.org используйте параметр для запуска TestTool из командной строки
= TestTool Editor =
+
'''-enableautomation'''
The TestTool uses syntax highlighting for all BASIC, StarBasic, and internal TestTool commands (For more information, see: [[VCLTesttool/API_reference|Internal Commands, Methods and Functions for TestTool]]). Highlighting can increase the load time for large files.
+
В среде TestTool запустится крипт с расширением '''*.bas'''. Для запуска скрипта загрузите '''*.bas-файл''', и затем выполните этот скрипт через меню или комбинацию горячих клавиш.
 
 
= Starting a TestTool Script =
 
Start local OpenOffice.org installations using the TestTool command line parameter ''-enableautomation''. In the ''TestTool Environment'', executable scripts use the *.''bas'' extension. To run a script, load a ''<nowiki>*.bas</nowiki>''-file, and then run the script from the menu or with a shortcut.
 
  
  
 
{| class="prettytable"
 
{| class="prettytable"
! colspan="2" | [[Image:tt_run.jpg]]
+
! colspan="6" | [[Image:tt_run.jpg]]
 +
|-
 +
!'''Клавиша'''
 +
!'''Меню'''
 +
!'''Описание'''
 +
!'''Клавиша'''
 +
!'''Меню'''
 +
!'''Описание'''
 +
|-
 +
| {{Key|F5}}
 +
|''Stert''
 +
|Запуск скрипта, создание нового или открытие старого файла результатов, и вставка результатов теста в файл результатов.
 +
|{{Key|Shift|F5}}
 +
|''Cancel''
 +
|Завершение выполнение скрипта
 +
|-
 +
|{{Key|F8}}
 +
|''Single stepping''
 +
|Запуск пошагового выполнения скрипта.
 +
|{{Key|Ctrl|F5}}
 +
|''Interrupt''
 +
|Прерывание выполняемого сценария.
 +
|-
 +
|{{Key|F9}}
 +
|''Set / Select a break point''
 +
|Создание точки останова (красный круг) в скрипте на синем бордюре с левой стороны.
 +
|{{Key|Shift|F7}}
 +
|''Previous Error''
 +
|Перейти к предыдущей ошибке в сценарии.
 +
|-
 +
|{{Key|F10}}
 +
|''Single step over procedures''
 +
|Выполнение по одной подпрограмме скрипта за один раз.
 +
|{{Key|Shift|F8}}
 +
|''Next Error''
 +
|Перейти к следующей ошибке после синтаксической ошибки в скрипте.
 +
|}
  
|-
+
= Файл результатов =
| ''' F5 Start'''
 
:Starts the script, opens a new or old result file, and inserts the result of the test in the file.
 
  
''' F8 Single stepping'''
+
TestTool автоматически сохраняет результаты в файл результатов в течении всего времени выполнения тестов. Имя файлу результатов даётся по имени выполняемого файла сценария (*.bas-файла), результаты которого сохраняются; при этом файлу результатов даётся другое расширение: '''*.res'''.
: Runs the script by single steps.
 
  
''' F10 Single step over procedures'''
+
Например: ''{{Menu|first.bas|first.res}}''.
: Runs the script one sub routine at a time.
 
  
''' F9 Set / Select a break point'''
+
Для установки пути сохранения файла результатов, выберите меню {{Menu|Extra|Settings|Profile}} и введите путь в графу '''Log Base directory'''.
: Creates a breakpoint (red circle) in the script on the blue border on the left side.
 
  
|''' Shift+F5 Cancel '''
+
Если файл результатов уже есть, то файл будет открыт и новые результаты будут добавлены в начало файла.
: Cancels a running script.
 
'''Ctrl+F5 Interrupt'''
 
:Interrupts a running script.
 
  
'''Shift+F8 Next Error'''
+
Результаты представляются в виде иерархического дерева. Каждую ветвь дерева можно развернуть для просмотра её содержимого. Для этого нужно щёлкнуть по '''[+]''' в дереве. Чтобы свернуть ветвь, нужно щёлкнуть по '''[-]'''.
:Jumps to the next error after a syntax error in a script.
 
  
''' Shift+F7 Previous Error'''
+
[[Image:tt_result.png]]
:Jumps to the previous error in a script.
 
 
 
|}
 
 
 
= Result File =
 
The TestTool automatically saves a result file during a test script is run. The name of the result file is the name of the script *.bas-file that generated the result, but with the *.res extension (For example: ''first.bas -'' ''first.res''). To set the path for saving the result file, choose '''Extra - Settings - Profile''' and enter the path in the '''''Log Base directory''''' box.
 
  
If a result file already exists, the file is opened and the new result is added at the beginning of the file.
+
*Первый этап - ''Чтение файлов''. Разверните его, чтобы просмотреть список файлов. Если список окрашен в оранжевый цвет, значит файлы (*.win / *.sid) содержат ошибки. Сумма ошибок показывается в конце теста как предупреждения, произошедшие в ходе инициализации.
 
+
* Следующий вывод содержит автоматически сгенерированное вступление ''Запуск процедуры''. В нём отображается информация о версии TestTool, пути установки OpenOffice.org, а так же о запущенном приложении. Отображается локаль Офиса и системы.
The results are presented as a hierarchical tree list where you can click plus sign (+) or minus sign (-) to expand or collapse the outputs.
+
* Каждая запись, которой предшествует '''[+]''' является блоком тестов. Если блок тестов окрашен в цвет отличный от чёрного, значит этот тест содержит ошибки.
 
+
* Оранжевый блок тестов указывает на одно или больше предупреждений. Чтобы увидеть, где произошла ошибка, раскройте секцию и изучите лог предупреждений, который следует отправить разработчикам данного тестового скрипта. Чтобы перейти непосредственно к месту скрипта, где произошла ошибка, дважды щёлкните по этому предупреждению.
[[Image:tt_result.png]]
+
* Светло-зелёный цвет блока обозначает QAErrorLog, вставленный разработчиками в данный раздел тестов, чтобы дать тестерам дополнительную информацию (например - о возникших ошибках и способах их обхода).
*The first output is ''Reading the files''. Expand this entry to see the declaration files. If the entry is orange, the declaration files (*.win / *.sid) contain errors. The sum of the errors is displayed at the end of a test as Warnings occurred during initialization.
+
* Светло-синий цвет блока обозначает утверждение о предоставлении дополнительной информации для тестирования и отладки сборки OpenOffice.org.
* The next output is a short entry that is generated automatically by the ''start up routines''. The entry displays information about the TestTool version, the paths where OpenOffice.org is installed, and where the application was started. The office- and the system language is also displayed.
+
* Красный блок показывает наличие одной или более ошибок. Раскрытие данной ветки дерева покажет подробную информацию о проблемах. В примере результирующего файла ошибка произошла, когда TestTool не нашёл слот, потому что в нём есть опечатка "ToosOptions" вместо "Too'''l'''sOptions".
* <nowiki>Each entry that has a [+] in front of it is a testcase. If the testcase entry is a color other than black, the test contains errors.</nowiki>
+
* Раскрывайте красную группу по щелчку на '''[+]''' напротив группы уровень за уровнем (главный - блок тестов... - подпрограмма... - ...) для просмотра всех ошибок. Вы так же можете увидеть, что TestTool получил в ответ от OpenOffice.org, так как TestTool может работать запускать следующие тестовые блоки без вывода окон и диалогов. Например:  
* An orange testcase indicates that one or more warnings are present. To see where the error occurred, expand the entry and examine the warnlogs, which are the outputs from the developer of the test script. To jump directly to the place in the test script where a warning occurred, double-click the warning.
 
* A light green testcase indicates a QAErrorLog entry that was inserted by the developer of the testcase to give the tester some information (for example, about an existing bug or workaround)
 
* A light blue testcase indicates an Assertion that gives selectable informatoins when testing a debug build of OpenOffice.org.
 
* A red testcase indicates that one or more errors are present. The tree is expanded to display the error(s). In the example result file, the error occurred when the TestTool did not find the slot. That is because there is a typo in it – it should be ToolsOptions.
 
* When you expand a red entry by clicking the plus sign (+) in front of the entry, a level by level (sub main - testcase ... - subroutine ... - .....) view of the error is displayed. You can also see what the TestTool did to return OpenOffice.org to a defined base state so that the TestTool can run the next testcase without any open windows or dialogs.For example:  
 
 
** the WORKINGWINDOW "Untitled2 - OpenOffice.org Writer" is closed (geschlossen = closed)
 
** the WORKINGWINDOW "Untitled2 - OpenOffice.org Writer" is closed (geschlossen = closed)
 
** Explanation:
 
** Explanation:
 
** the working document is closed
 
** the working document is closed
 
** The TestTool then started the next testcase at the base state of OpenOffice.org (that is, with one open document and no open dialog).
 
** The TestTool then started the next testcase at the base state of OpenOffice.org (that is, with one open document and no open dialog).
* At the end of a test, the number of errors and warnings is displayed
+
* В конце теста выводятся номера ошибок и предупреждений.
 +
 
 +
= Запуск сценария тестов из командной строки =
  
= Starting a Test Script From the Command Line =
+
Для запуска сценария тестирования из командной строки используйте следующий синтаксис:
To start a test-script from the command line, use the following syntax:
 
  
  
 
{| class="prettytable"
 
{| class="prettytable"
|  
+
|  
| '''<nowiki>testtool.exe [/port=xxx /host=xxx] startprogram /run</nowiki>''' '''<nowiki>[/result xxx]</nowiki>''' '''<nowiki>[/printlog]</nowiki>'''
+
| '''<nowiki>testtool.exe [/port=xxx /host=xxx] startprogram /run</nowiki>''' '''<nowiki>[/result xxx]</nowiki>''' '''<nowiki>[/printlog]</nowiki>'''
 +
 
 +
|-
 +
| <div align="right">'''/Port '''</div>
 +
| Указывается com-порт на машине, выделяемый TestTool для связи с OpenOffice.org. Если вы опустите этот параметр, TestTool будет использовать соответствующий параметр из файла
 +
{{DocLinux| '''.testtoolrc'''}}
 +
или
 +
{{DocWindows| '''testtool.ini'''}}
  
|-
+
|-
| <div align="right">'''/Port '''</div>
+
| <div align="right">'''/Host '''</div>
| The com port on the machine that the TestTool uses to communicate with OpenOffice.org. If you do not include this parameter, the TestTool looks for relevant information in the '''''.testtoolrc''''' or '''''testtool.ini''''' files.
+
| Указывается имя хоста машины, на которой установлен тестируемый OpenOffice.org. Если OpenOffice.org находится на той же машине, что и TestTool, введите '''localhost'''. Если вы опустите этот параметр, TestTool будет использовать соответствующий параметр из файла
 +
{{DocLinux| '''.testtoolrc'''}}
 +
или
 +
{{DocWindows| '''testtool.ini'''}}
 +
но только в случае использования ''localhost''!
  
|-
+
|-
| <div align="right">'''/Host '''</div>
+
| <div align="right">'''Startprogram '''</div>
| The ''hostname'' of the machine that contains the OpenOffice.org installation that you want to test. If the installation is on the same machine as the TestTool, enter '''localhost'''. If you do not include this parameter, the TestTool looks for relevant information in the '''''.testtoolrc''''' or '''''testtool.ini''''' files.(only ''localhost'' is supported)
+
| Указания файла-сценариев '''*.bas''', который необходимо запустить на выполнение.
  
|-
+
|-
| <div align="right">'''Startprogram '''</div>
+
| <div align="right">'''/run'''</div>
| The *.bas-file that contains the main-routine.
+
| Запуск сценариев тестирования и запись результатов в результирующий файл, и выход из TestTool по окончании тестов.
  
|-
+
|-
| <div align="right">'''/run'''</div>
+
| <div align="right">'''/result'''</div>
| Runs the test script, writes the result to the result file, and exits the TestTool at the end of the test.  
+
| Ограничивает количество тестов до Х исключая уже выполненные. Данные о выполненных тестах будут взяты из файла результатов.
  
|-
+
|-
| <div align="right">'''/result'''</div>
+
|<div align="right">'''/printlog'''</div>
| Limits the number of testruns to xxx excluding the current one in the resultfile (0,1,2,...). The action gets executed on running the testcase.
+
|{{DocLinux| '''Писать данные, записанные в журналы, в стандартный вывод'''<br>*****  UNIX only ! *****}}
|-
 
|<div align="right">'''/printlog'''</div>
 
|write the information written to logs on stdout *****  UNIX only ! *****
 
  
|}
+
|}
  
 
{| class="prettytable"
 
{| class="prettytable"
| Example:
+
| Например:
| '''testtool.exe /port=12481 /host=localhost  /opt/qatesttool/writer/update/w_update.bas /run'''
+
| '''testtool.exe /port=12481 /host=localhost  /opt/qatesttool/writer/update/w_update.bas /run'''
  
|-
+
|-
|  
+
|  
| The TestTool runs the '''w_update.bas'''-test on the local machine through port 12481, and exits the TestTool when the test is done.
+
| TestTool запускает сценарий '''w_update.bas''' на локальной машине через порт 12481, и завершает TestTool по окончании тестов.
 +
|}
  
|}
+
= Пакетное выполнение сценариев тестирования =
  
= Run a Batch with Testcases =
+
: Примеры для Win32 и Unix приведены в статье http://hg.services.openoffice.org/DEV300/file/1467f46f8817/testautomation/tools/run_tests.
  
: There are examples for Win32 and Unix at http://hg.services.openoffice.org/DEV300/file/1467f46f8817/testautomation/tools/run_tests.
+
= Тестирование Non-Product-сборки  =
 
+
Non-Product Version / [[Non_Product_Build|Non-Product Build]] - версия не для распространения, содержащая дополнительный отладочный код.
= Testing a Non-Product Version  =
+
  Предназначена для технических специалистов, отличается большим размером и низкой производительностью.
* Define the files where you want to store the debug-settings for OpenOffice.org by inserting the following section into the '''''win.ini''''' file (If you don't have access to the file, you may use environment variables.):
+
* Определите файл, где вам необходимо хранить переменные отладки для OpenOffice.org, включив соответствующую секцию в '''''win.ini'''''-файле. (Если вы не имеете доступа к этому файлу, вы можете использовать переменные окружения.):
 
   <nowiki>[SV]</nowiki>
 
   <nowiki>[SV]</nowiki>
 
   dbgsv<nowiki>=c:\</nowiki>dbgsv.ini
 
   dbgsv<nowiki>=c:\</nowiki>dbgsv.ini
 
   dbgsvlog<nowiki>=c:\</nowiki>dbgsv.log  
 
   dbgsvlog<nowiki>=c:\</nowiki>dbgsv.log  
* On Linux/Unix/Win32 Platforms you have to set an environment variable to control where the debug-settings are stored:
+
 
 +
* На платформе Linux/Unix/Win32 вы можете установить и сохранить переменные окружения:
 
   DBGSV_INIT=/some/path/dbgsv.ini
 
   DBGSV_INIT=/some/path/dbgsv.ini
 
   DBGSV_LOG=/some/path/dbgsv.log
 
   DBGSV_LOG=/some/path/dbgsv.log
* In OpenOffice.org, press '''Shift+Ctrl+Alt+D''', and then select ''TestTool'' in the '''Error '''list box.
+
* В OpenOffice.org, нажмите {{Key|Shift|Ctrl|Alt|D}}, и выберите ''TestTool'' в списке '''Error '''.
* In the TestTool, assertions are indicated by light blue. To manually reproduce an assertion, select ''MessageBox'' in the '''Error '''list box''.''
+
* В TestTool, соответствующая индикация будет светло-голубой. Чтобы вручную воспроизвести утверждение, выберите в ''списке'' '''Error '''.
  
=The TestTool Environment=
+
= Окружение TestTool =
  
The TestTool Environment contains the start scripts, the test scripts, and the libraries (''include files'') that are required to automatically test OpenOffice.org. The TestTool Environment is modular, so that a module exits for each application or area that you want to test in OpenOffice.org. To test a single OpenOffice.org application, such as Writer, you only need the ''application module'' and the ''global'' module.
+
Окружение TestTool позволяет запускать сценарии, содержит скрипты тестов, и библиотеки (''включённых файлов''), с помощью которых проводится автоматическое тестирование OpenOffice.org. Окружение TestTool имеет отдельные модули для каждого приложения или области, которую вам необходимо протестировать в OpenOffice.org. Для проверки приложения OpenOffice.org, такого какWriter, потребуется только ''application module'' и модуль ''global''.
  
 
{| class="prettytable"
 
{| class="prettytable"
! module name / path name
+
! Имя модуля / Путь
! Description
+
! Описание
  
 
|-
 
|-
 
| colspan="2" |  
 
| colspan="2" |  
==application modules==
+
==Модули приложений==
  
 
|-
 
|-
 
| '''dbaccess'''
 
| '''dbaccess'''
| Database / Data source functionality in OpenOffice.org
+
| База данных / Источник Данных, работающие в OpenOffice.org
  
 
|-
 
|-
 
| '''spreadsheet'''
 
| '''spreadsheet'''
| Calc (spreadsheet)
+
| Calc (Электронная таблица)
  
 
|-
 
|-
 
| '''chart2'''
 
| '''chart2'''
| Chart, the functionality of charts in a spreadsheet
+
| Диаграммы электронных таблиц
  
 
|-
 
|-
 
| '''graphics'''
 
| '''graphics'''
| Impress (presentation application) and Draw (drawing application)
+
| Impress (приложение для создания презентаций) и Draw (графический редактор)
  
 
|-
 
|-
 
| '''math'''
 
| '''math'''
| Math (formula)
+
| Math (редактор формул)
  
 
|-
 
|-
 
| '''extensions'''
 
| '''extensions'''
| Extensions functionalities
+
| Работа с расширениями
  
 
|-
 
|-
 
| '''writer'''
 
| '''writer'''
| Writer (text document, HTML document, master document)
+
| Writer (текстовый процессор, редактор HTML-документов и составных документов)
  
 
|-
 
|-
 
| '''xml'''
 
| '''xml'''
| XML file format for all of the OpenOffice.org applications
+
| Поддержка формата XML-файлов для всего OpenOffice.org
  
 
|-
 
|-
| colspan="2" |  
+
| colspan="2" |
==general modules==
+
 
 +
==Общие модули==
  
 
|-
 
|-
 
| '''framework'''
 
| '''framework'''
| General functionality for all applications (for example, galleries and extras)
+
| Общая функциональность для всех приложений (например - галерей и расширений)
  
 
|-
 
|-
 
| '''global'''
 
| '''global'''
| All general routines (for example, startup, tooling, declaration files)
+
| Все общие процедуры (например - запуск, инструменты, объявление файлов)
  
 
|-
 
|-
 
| '''tools'''
 
| '''tools'''
| Useful standalone applications (hid.lst perl script)
+
| Полезные автономные приложения (hid.lst perl script)
  
 
|}
 
|}
The following subcategories are defined for the TestTool Environment modules:
 
  
 +
 +
Следующие подкатегории определены для модулей в окружении TestTool:
  
 
{| class="prettytable"
 
{| class="prettytable"
! module name / path name
+
! Имя модуля / Путь
! Description
+
! Описание
  
 
|-
 
|-
 
| '''required'''
 
| '''required'''
| Resource test: Activates all menu items and opens all dialogs of the tested application.
+
| Тест ресурсов: Активирует все пункты меню и открывает все диалоги в проверяемом приложении.
  
 
|-
 
|-
 
| '''optional'''
 
| '''optional'''
| Performs a general functionality test for each feature in the tested application, including each menu item.
+
| Выполняет функции общего назначения для каждой функции в тестируемом приложении, в том числе по каждому пункту меню.
  
 
|-
 
|-
 
| '''tools'''
 
| '''tools'''
| Includes libraries that contain the general subroutines that are required by all test scripts in the module or application.
+
| Подключает библиотеки, которые содержат общие подпрограммы, необходимые для всех сценариев тестирования в модулях или приложениях.
  
 
|}
 
|}
These are only the defined name, you can also find other subcategories in the paths. Mostly the named of the directory mirror the tested area.
 
  
If you find a ''<nowiki>*.bas</nowiki>''-file in one of these directories you are in a test-module. Those module should include the following directories/files:
+
Эти предопределённые имена так же могут находиться в других подкатегориях пути. Чаще всего имя директории является зеркальным отражением имени тестируемой области.
 +
 
 +
Если вы нашли ''*.bas''-файл в одной из директорий, значит вы находитесь в модуле тестирования. То есть, модуль должен вклчать следующие каталоги / файлы:
  
  
 
{| class="prettytable"
 
{| class="prettytable"
! module name / path name
+
! Имя модуля / Путь
! Description
+
! Описание
  
 
|-
 
|-
| '''<nowiki>*</nowiki>.bas'''
+
| '''*.bas'''
| Indicates executable test scripts. To run the script, open the *.bas file in TestTool, and then press F5 or choose '''Program - Start'''.
+
| Содержит выполняемые сценарии тестирования. Для запуска данного скрипта, откройте *.bas-файл в TestTool, и нажмите {{Key|F5}} или выберите в меню {{Menu|Program|Start}}.
  
 
|-
 
|-
 
| '''inc'''
 
| '''inc'''
| Includes the libraries and any associated files that are required for a test (included by ''use''-method in the ''<nowiki>*.bas</nowiki>''-file)
+
| Содержит библиоткеи и любые ассоциированные файлы, требуемые при тестировании (включены в ''use''-метод в ''*.bas''-файле).
  
 
|-
 
|-
 
| '''input'''
 
| '''input'''
| Inputs the files that are required for the test.
+
| Файл данных, требуемых при тестировании.
  
 
|-
 
|-
 
| '''tools'''
 
| '''tools'''
| Includes libraries that have general subroutines that are required by test scripts (*.bas). The libraries must be in the same directory as the test script.
+
| Включает библиотеки, содержащие общие подпрограммы, используемые в сценариях тестирования (*.bas). Эти библиотеки должны быть в том же каталоге, что и скрипт теста.
  
 
|}
 
|}
== global-Module ==
+
 
The ''global-directory'' is required for each test. The directory contains the main routines for running a test script, including the ''hid.lst'', the declaration files that identify menu items, dialogs and controls in OpenOffice.org, and general tooling routines.
+
== Общие модули ==
 +
Параметр ''global-directory'' требуется для каждого теста. Этот каталог содержит главные процедуры для выполняемых сценариев тестирования, включённых в файл ''hid.lst'', являющегося декларацией, определяющей пункты меню, диалоги, элементы управления OpenOffice.org, а так же общие процедурные инструменты.
  
  
 
{| class="prettytable"
 
{| class="prettytable"
! directory name
+
! Имя каталога
! description
+
! Описание
  
 
|-
 
|-
 
| '''hid'''
 
| '''hid'''
| Contains the ''hid.lst'' file.
+
| Содержит файл ''hid.lst''.
  
 
|-
 
|-
 
| '''input'''
 
| '''input'''
| Contains common files that are required by the TestTool.
+
| Содержит общие файлы, требующиеся TestTool.
 
+
* переводит '''office language dependent''' умолчальный фильтр имён каждого приложения (''filters''-каталог)
* translated, '''office language dependent''' default filter names for each application (''filters''-directory)
+
* переводит '''office language dependent''' имена OLE-объектов (''olenames''-каталог)
* translated, '''office language dependent '''OLE-object names (''olenames''-dir)
+
* фильтры для каждого графического формата, который может прочесть OpenOffice.org (''graf_inp''-каталог)
* files for each graphic format that OpenOffice.org can read (''graf_inp''-dir)
 
 
 
 
 
 
 
 
|-
 
|-
 
| '''sid'''
 
| '''sid'''
| Includes all SlotID declarations.
+
| Включает в себя все декларации SlotID.
  
 
|-
 
|-
 
| '''system'''
 
| '''system'''
| Contains the routines to start a test script in these inc-files.
+
| Содержит процедуры для запуска сценариев тестирования в inc-файлах.
  
 
|-
 
|-
 
| '''tools'''
 
| '''tools'''
| Contains general tooling routines in these inc-files (for example, ''declare.bas'').
+
| Содержит общие процедуры в inc-файлах (Например: ''declare.bas'').
  
 
|-
 
|-
 
| '''update'''
 
| '''update'''
| Contains general resource-test routines in these files (options-dialog and autopilots)
+
| Содержит общие ресурсы для тестов в файлах (опции диалогов и мастеров)
  
 
|-
 
|-
 
| '''win'''
 
| '''win'''
| Contains all HelpID declarations.
+
| Содержит все декларации HelpID.
  
 
|}
 
|}
  
=Configuration file entries=
+
=Конфигурирование файла настроек=
The configuration file (UNIX: ''.testtoolrc'', Win32: ''testtool.ini'') contains several sections.<nowiki>The section name is surounded by '[', ']' and contains several entries like: EntryName=Value.</nowiki>
+
 
 +
Конфигурационный файл TestTool
 +
{{DocLinux| '''.testtoolrc'''}}
 +
{{DocWindows| '''testtool.ini'''}}
 +
содержит несколько секций.
  
== GUI Platform ==
+
Имена секций заключены в квадратные скобки [...].
''Current='' depends on the Platform.
+
 
 +
Каждая секция содержит несколько записей на подобии:
 +
EntryName=Value
 +
 
 +
== Платформа GUI ==
 +
''Current='' зависит от платформы.
  
  
Line 406: Line 493:
  
 
|-
 
|-
| '''Subsystem'''
+
| '''Подсистема'''
| '''Current'''
+
| '''Значение'''
| '''Subsystem'''
+
| '''Подсистема'''
| '''Current'''
+
| '''Значение'''
  
 
|-
 
|-
Line 497: Line 584:
 
|}
 
|}
  
[[Category:TestAutomation]]
+
 
 +
{{SignTransYear|RU|Sancho|А. Е. Харламенков|2010}}
 +
 
 +
{{RUqaBottom}}

Latest revision as of 19:56, 18 September 2011



Инструментарий для автоматического тестирования OpenOffice.org

О TestTool

TestTool - это программа, предназначенная для автоматизированного тестирования OpenOffice.org. TestTool взаимодействует через TCP/IP-интерфейс с OpenOffice.org и выполняет тестирование установленного на PC OpenOffice.org. Текущая версия TestTool предназначена для работы с OpenOffice.org 3.0 и выше. Однако, в будущем в OpenOffice.org могут быть внесены несовместимые изменения и потребуется обновить версию TestTool.

TestTool связывается с OpenOffice.org, используя SlotIDs, UniqueIDs, и HelpIDs для управления каждым пунктом меню, окнами, диалогами, и диалоговыми параметрами в OpenOffice.org. Идентификаторы генерируются автоматически в OpenOffice.org построителями процессов или назначаются разработчиками.


SlotIDs Каждый пункт меню имеет SlotID который используется, например, чтобы открыть диалог или совершить действие.
HelpIDs Каждый элемент управления, окно или диалог автоматически получает HelpID для внутренней справочной системы. TestTool использует HelpIDs для идентификации конкретного элемента управления, окна или диалога.
UniqueIDs Разработчики могут назначать UniqueID элементам управления, которые не имеют собственного HelpID, чтобы TestTool мог идентифицировать данный контрол.


Вы можете создать скрипт теста для TestTool на языке программирования StarBasic (подобный VisualBasic). Некоторые команды доступны для TestTool, например, получить или разместить информацию в элементе управления OpenOffice.org. Есть полный список доступных команд, описывающий внутренние команды, методы, и функции TestTool [en]. Вы можете симулировать большинство действий мыши и клавиатуры из TestTool, а так же собирать информацию из элементов управления или изменять установки по умолчанию в OpenOffice.org. Иными словами, TestTool позволяет симулировать поведение пользователя OpenOffice.org.

Расположение TestTool

Окружающая среда TestTool может быть проверена на Mercurial в openoffice.org, и находится в каталоге: testautomation; Или она доступна в виде отдельно пакета.

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

.../{officepath}/program.

Запустите программу

Documentation linux.png testtool.bin

или

Documentation windows.png testtool.exe

или

Documentation Mac Logo 40.png скопируйте скрипт soffice в testtool и запустите его.

Установка TestTool

Для установки TestTool, распакуйсте содержимое загруженного архива TestTool на локальный диск. Если TestTool планируют использовать несколько пользователей, скопируйте распакованный архив на сетевой диск.

После запуска TestTool выполняет файл настроек

Documentation linux.png .testtoolrc

или

Documentation windows.png testtool.ini

Если ваш файл настроек TestTool расположен в том же каталоге, что и исполняемые файлы TestTool, то он автоматически буде скопирован в каталог

Documentation linux.png home

или

Documentation windows.png профиль


Documentation linux.png Только для Linux: Если вы получили сообщение, аналогичное этому:

"Couldn't bootstrap uno servicemanager for reason : Couldn't create registry file ...services.rdb for writing",
убедитесь, что вы используете nfslock.
Например, в Linux запустите
/etc/init.d/nfslock status
Если команда не выполняется, то измените от имени root и выполните
/etc/init.d/nfslock start и
chkconfig nfslock on.
Это необходимо для дистрибутивов TurboLinux и SuSe 8.1.

Настройка TestTool

Выберите Extra → Settings → Profile.

Testtool-option-profile.jpg
1. Profile: Введите название вашего профиля.
2. Log base directory: Введите путь, куда будут сохраняться результаты тестов.
Например:
Documentation linux.png /opt/qa/qatesttool/errorlog/mymachine

или

Documentation windows.png d:\qa\qatesttool\errorlog\mymachine
3. Base directory: Введите полный путь к Окружению TestTool (БЕЗ завершающего слэша!).
Например:
Documentation linux.png /opt/qa/qatesttool

или

Documentation windows.png d:\qa\qatesttool
4. Default HID directory: Отметьте данный флажок.


При необходимости можно изменить эти настройки в соответствующем конфигурационном файле

Documentation linux.png .testtoolrc
Documentation windows.png testtool.ini


CurrentProfile=_profile_Default
(...)
[_profile_Default]
LogBaseDir=/opt/qa/qatesttool/errorlog/mymachine
BaseDir=/opt/qa/qatesttool
HIDDir=/opt/qa/qatesttool/global/hid

Автоматизированные креш-отчёты

Выберите меню Extra → Settings → Crashreport.


Testtool-option-crashreport.jpg
1. Use Proxy Выберите, если доступ в интернет осуществляется через прокси.
2. Host Адрес прокси. Например:
proxy.somewhere.de
3. Port Введите номер порта прокси. Например:
8080
4. Allow Contact Отметьте этот флажок, если вы разрешите отправлять вам письма касательно ваших креш-отчётов.
5. Email Адрес вашей электропочты. Например:
you@somewhere.de


В последствии можно отредактировать все эти параметры в конфигурационных файлах

Documentation linux.png .testtoolrc
Documentation windows.png testtool.ini


[Crashreporter]
UseProxy=true
ProxyServer=proxy.somewhere.de
ProxyPort=8080
AllowContact=true
ReturnAddress=you@somewhere.de

Выбор установки OpenOffice.org

Есть два варианта:

Выберите меню Extra → Settings → Misc.

Testtool-option-misc.jpg
1. OOo Program Dir Выберите установку OpenOffice.org, предназначенного для тестирования. Например:
/Volumes/OpenOffice.org 2.0.app/Contents/MacOS


В последствии можно отредактировать все эти параметры в конфигурационных файлах

Documentation linux.png .testtoolrc
Documentation windows.png testtool.ini
[OOoProgramDir]
Type=Path
Current=/Volumes/OpenOffice.org 2.0.app/Contents/MacOS
All=/Volumes/OpenOffice.org 2.0.app/Contents/MacOS

Редактор TestTool

TestTool использует подсветку синтаксиса для всего BASIC, StarBasic, и внутренних комманд TestTool. Подробная информация описана в разделе Внутренние команды, методы и функции TestTool [en]. Подсветка может увеличивать время загрузки больших файлов.

Запуск скрипта TestTool

Для запуска установленного OpenOffice.org используйте параметр для запуска TestTool из командной строки

-enableautomation

В среде TestTool запустится крипт с расширением *.bas. Для запуска скрипта загрузите *.bas-файл, и затем выполните этот скрипт через меню или комбинацию горячих клавиш.


Tt run.jpg
Клавиша Меню Описание Клавиша Меню Описание
 F5  Stert Запуск скрипта, создание нового или открытие старого файла результатов, и вставка результатов теста в файл результатов.  ⇧ Shift  +  F5  Cancel Завершение выполнение скрипта
 F8  Single stepping Запуск пошагового выполнения скрипта.  Ctrl  +  F5  Interrupt Прерывание выполняемого сценария.
 F9  Set / Select a break point Создание точки останова (красный круг) в скрипте на синем бордюре с левой стороны.  ⇧ Shift  +  F7  Previous Error Перейти к предыдущей ошибке в сценарии.
 F10  Single step over procedures Выполнение по одной подпрограмме скрипта за один раз.  ⇧ Shift  +  F8  Next Error Перейти к следующей ошибке после синтаксической ошибки в скрипте.

Файл результатов

TestTool автоматически сохраняет результаты в файл результатов в течении всего времени выполнения тестов. Имя файлу результатов даётся по имени выполняемого файла сценария (*.bas-файла), результаты которого сохраняются; при этом файлу результатов даётся другое расширение: *.res.

Например: first.bas → first.res.

Для установки пути сохранения файла результатов, выберите меню Extra → Settings → Profile и введите путь в графу Log Base directory.

Если файл результатов уже есть, то файл будет открыт и новые результаты будут добавлены в начало файла.

Результаты представляются в виде иерархического дерева. Каждую ветвь дерева можно развернуть для просмотра её содержимого. Для этого нужно щёлкнуть по [+] в дереве. Чтобы свернуть ветвь, нужно щёлкнуть по [-].

Tt result.png

  • Первый этап - Чтение файлов. Разверните его, чтобы просмотреть список файлов. Если список окрашен в оранжевый цвет, значит файлы (*.win / *.sid) содержат ошибки. Сумма ошибок показывается в конце теста как предупреждения, произошедшие в ходе инициализации.
  • Следующий вывод содержит автоматически сгенерированное вступление Запуск процедуры. В нём отображается информация о версии TestTool, пути установки OpenOffice.org, а так же о запущенном приложении. Отображается локаль Офиса и системы.
  • Каждая запись, которой предшествует [+] является блоком тестов. Если блок тестов окрашен в цвет отличный от чёрного, значит этот тест содержит ошибки.
  • Оранжевый блок тестов указывает на одно или больше предупреждений. Чтобы увидеть, где произошла ошибка, раскройте секцию и изучите лог предупреждений, который следует отправить разработчикам данного тестового скрипта. Чтобы перейти непосредственно к месту скрипта, где произошла ошибка, дважды щёлкните по этому предупреждению.
  • Светло-зелёный цвет блока обозначает QAErrorLog, вставленный разработчиками в данный раздел тестов, чтобы дать тестерам дополнительную информацию (например - о возникших ошибках и способах их обхода).
  • Светло-синий цвет блока обозначает утверждение о предоставлении дополнительной информации для тестирования и отладки сборки OpenOffice.org.
  • Красный блок показывает наличие одной или более ошибок. Раскрытие данной ветки дерева покажет подробную информацию о проблемах. В примере результирующего файла ошибка произошла, когда TestTool не нашёл слот, потому что в нём есть опечатка "ToosOptions" вместо "ToolsOptions".
  • Раскрывайте красную группу по щелчку на [+] напротив группы уровень за уровнем (главный - блок тестов... - подпрограмма... - ...) для просмотра всех ошибок. Вы так же можете увидеть, что TestTool получил в ответ от OpenOffice.org, так как TestTool может работать запускать следующие тестовые блоки без вывода окон и диалогов. Например:
    • the WORKINGWINDOW "Untitled2 - OpenOffice.org Writer" is closed (geschlossen = closed)
    • Explanation:
    • the working document is closed
    • The TestTool then started the next testcase at the base state of OpenOffice.org (that is, with one open document and no open dialog).
  • В конце теста выводятся номера ошибок и предупреждений.

Запуск сценария тестов из командной строки

Для запуска сценария тестирования из командной строки используйте следующий синтаксис:


testtool.exe [/port=xxx /host=xxx] startprogram /run [/result xxx] [/printlog]
/Port
Указывается com-порт на машине, выделяемый TestTool для связи с OpenOffice.org. Если вы опустите этот параметр, TestTool будет использовать соответствующий параметр из файла
Documentation linux.png .testtoolrc

или

Documentation windows.png testtool.ini
/Host
Указывается имя хоста машины, на которой установлен тестируемый OpenOffice.org. Если OpenOffice.org находится на той же машине, что и TestTool, введите localhost. Если вы опустите этот параметр, TestTool будет использовать соответствующий параметр из файла
Documentation linux.png .testtoolrc

или

Documentation windows.png testtool.ini
но только в случае использования localhost!
Startprogram
Указания файла-сценариев *.bas, который необходимо запустить на выполнение.
/run
Запуск сценариев тестирования и запись результатов в результирующий файл, и выход из TestTool по окончании тестов.
/result
Ограничивает количество тестов до Х исключая уже выполненные. Данные о выполненных тестах будут взяты из файла результатов.
/printlog
Documentation linux.png Писать данные, записанные в журналы, в стандартный вывод
***** UNIX only ! *****
Например: testtool.exe /port=12481 /host=localhost /opt/qatesttool/writer/update/w_update.bas /run
TestTool запускает сценарий w_update.bas на локальной машине через порт 12481, и завершает TestTool по окончании тестов.

Пакетное выполнение сценариев тестирования

Примеры для Win32 и Unix приведены в статье http://hg.services.openoffice.org/DEV300/file/1467f46f8817/testautomation/tools/run_tests.

Тестирование Non-Product-сборки

Non-Product Version / Non-Product Build - версия не для распространения, содержащая дополнительный отладочный код.
Предназначена для технических специалистов, отличается большим размером и низкой производительностью.
  • Определите файл, где вам необходимо хранить переменные отладки для OpenOffice.org, включив соответствующую секцию в win.ini-файле. (Если вы не имеете доступа к этому файлу, вы можете использовать переменные окружения.):
 [SV]
 dbgsv=c:\dbgsv.ini
 dbgsvlog=c:\dbgsv.log 
  • На платформе Linux/Unix/Win32 вы можете установить и сохранить переменные окружения:
 DBGSV_INIT=/some/path/dbgsv.ini
 DBGSV_LOG=/some/path/dbgsv.log
  • В OpenOffice.org, нажмите  ⇧ Shift  +  Ctrl  +  Alt  +  D , и выберите TestTool в списке Error .
  • В TestTool, соответствующая индикация будет светло-голубой. Чтобы вручную воспроизвести утверждение, выберите в списке Error .

Окружение TestTool

Окружение TestTool позволяет запускать сценарии, содержит скрипты тестов, и библиотеки (включённых файлов), с помощью которых проводится автоматическое тестирование OpenOffice.org. Окружение TestTool имеет отдельные модули для каждого приложения или области, которую вам необходимо протестировать в OpenOffice.org. Для проверки приложения OpenOffice.org, такого какWriter, потребуется только application module и модуль global.

Имя модуля / Путь Описание

Модули приложений

dbaccess База данных / Источник Данных, работающие в OpenOffice.org
spreadsheet Calc (Электронная таблица)
chart2 Диаграммы электронных таблиц
graphics Impress (приложение для создания презентаций) и Draw (графический редактор)
math Math (редактор формул)
extensions Работа с расширениями
writer Writer (текстовый процессор, редактор HTML-документов и составных документов)
xml Поддержка формата XML-файлов для всего OpenOffice.org

Общие модули

framework Общая функциональность для всех приложений (например - галерей и расширений)
global Все общие процедуры (например - запуск, инструменты, объявление файлов)
tools Полезные автономные приложения (hid.lst perl script)


Следующие подкатегории определены для модулей в окружении TestTool:

Имя модуля / Путь Описание
required Тест ресурсов: Активирует все пункты меню и открывает все диалоги в проверяемом приложении.
optional Выполняет функции общего назначения для каждой функции в тестируемом приложении, в том числе по каждому пункту меню.
tools Подключает библиотеки, которые содержат общие подпрограммы, необходимые для всех сценариев тестирования в модулях или приложениях.

Эти предопределённые имена так же могут находиться в других подкатегориях пути. Чаще всего имя директории является зеркальным отражением имени тестируемой области.

Если вы нашли *.bas-файл в одной из директорий, значит вы находитесь в модуле тестирования. То есть, модуль должен вклчать следующие каталоги / файлы:


Имя модуля / Путь Описание
*.bas Содержит выполняемые сценарии тестирования. Для запуска данного скрипта, откройте *.bas-файл в TestTool, и нажмите  F5  или выберите в меню Program → Start.
inc Содержит библиоткеи и любые ассоциированные файлы, требуемые при тестировании (включены в use-метод в *.bas-файле).
input Файл данных, требуемых при тестировании.
tools Включает библиотеки, содержащие общие подпрограммы, используемые в сценариях тестирования (*.bas). Эти библиотеки должны быть в том же каталоге, что и скрипт теста.

Общие модули

Параметр global-directory требуется для каждого теста. Этот каталог содержит главные процедуры для выполняемых сценариев тестирования, включённых в файл hid.lst, являющегося декларацией, определяющей пункты меню, диалоги, элементы управления OpenOffice.org, а так же общие процедурные инструменты.


Имя каталога Описание
hid Содержит файл hid.lst.
input Содержит общие файлы, требующиеся TestTool.
  • переводит office language dependent умолчальный фильтр имён каждого приложения (filters-каталог)
  • переводит office language dependent имена OLE-объектов (olenames-каталог)
  • фильтры для каждого графического формата, который может прочесть OpenOffice.org (graf_inp-каталог)
sid Включает в себя все декларации SlotID.
system Содержит процедуры для запуска сценариев тестирования в inc-файлах.
tools Содержит общие процедуры в inc-файлах (Например: declare.bas).
update Содержит общие ресурсы для тестов в файлах (опции диалогов и мастеров)
win Содержит все декларации HelpID.

Конфигурирование файла настроек

Конфигурационный файл TestTool

Documentation linux.png .testtoolrc
Documentation windows.png testtool.ini

содержит несколько секций.

Имена секций заключены в квадратные скобки [...].

Каждая секция содержит несколько записей на подобии:

EntryName=Value

Платформа GUI

Current= зависит от платформы.


UNIX Win32
Подсистема Значение Подсистема Значение
Solaris SPARC 01 Win 95 100
SCO UNIX 02 Win 98 395
Linux 03 Win NT 3 351
AIX 04 Win NT 4 400
Solaris x86 05 Win SE 410
Irix 06 Win ME 490
HP 07 Win 2000 500
FreeBSD 08 Win XP 501
Mac OS X 12 Win Server 2003 502
Linux PPC 13
NetBSD 14
Linux 64 bit 15
Linux SPARC 16
eComStation 17





Переводчик:
А. Е. Харламенков

2010










К началу страницы