Apache OpenOffice Wiki - User contributions [en]

File:StarXpert Xml2Calc.tar.gz

2010-09-30T22:15:23Z

Aeroshin: uploaded a new version of "File:StarXpert Xml2Calc.tar.gz": XSLT фильтр для импорта разнородных xml файлов в OpenOffice.org Calc XSLT filter for import any XML files into OpenOffice.org Calc

XSLT фильтр для импорта разнородных xml файлов в Calc

Documentation/Dashboard/Wiki Editing Policy

2010-09-06T13:52:05Z

Aeroshin: Fixing error in html tags

[[ru:RU/wiki_editing_policy|Политика Wiki-редактирования]]
{{Documentation/Banner}}
{{Documentation/DraftPage}}
{{DISPLAYTITLE:Wiki Editing Policy}}
[[fr:FR/Documentation/Dashboard/Wiki_Editing_Policy]]

This article helps you to contribute effectively to the Documentation part of the wiki. We strongly encourage you to announce new pages or major changes to the mailing list [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org].

= Project-independent ruleset =
{{Documentation/Note|See the general project-independent rules at [[OOo_Wiki_Contribution_Rules]] first!}}

=Prerequisites for Editing=

You must be registered and logged in before you can edit the Wiki. Registration is easily done.
# Click on '''Log in / create account''' in the upper right corner of the screen and enter the required bits. We recommend using the same username as on the OpenOffice.org website.
# Subsequently you have to validate your email address.

For further logins you use the same entry point, enter Username and Password, and click the '''Log in''' button.

Next step could be to tell the Community about yourself. There is definitely no harm and it is a good way of getting comfortable with the Wiki.
#When you are logged in, your username shows at the top of the page, in red, until you create your user page. Click on your username to do that.
#On your page, add some sections as given below, as it is your profile on the OpenOffice Wiki;
#* About yourself
#* OpenOffice and you
#* Your contributions
#* Work in progress
#* Any future plans?
#* Reference (optional)
#* Contact

So, this is somewhat a template, for creating a profile.
You may or may not need to follow this template, you may have sections of your choice. This is done to make a profile in a uniform way for all the new users.

=Adding Comments=

Important comments should be announced on the mailing list [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] to be sure that they get noticed.

To add a comment to a page
# Click the '''Discussion''' tab on the top of the page.
#* If you are starting a new topic click on the '''+''' sign to the right of the '''edit''' tab at the top, fill in the subject line and write your comment in the main text box.
#* If you want to add a comment to an existing discussion leave it after the existing comments and indent it by putting one or more colons (<code>:</code>) at the beginning of each paragraph.
# Sign your username with four tildes (<code><nowiki>~~~~</nowiki></code>). You can do this automatically with the '''signature with timestamp''' button ( http://wiki.services.openoffice.org/w/skins/common/images/button_sig.png ) on the toolbar.
# Click '''Save Page'''.

To learn more about comments see the [http://www.mediawiki.org/wiki/Help:Talk_pages Mediawiki help about talk pages]

=Structure of the [[Documentation]] Section of the Wiki=

The Documentation section is only part of the large OpenOffice.org Wiki. The doc.oo.o project
tries to present the information in this section in a way that it is easily accessible and
has a structure that allows straightforward navigation for both users and contributors.

All documentation pages are subpages of the main Documentation page. A further substructure
presents sections as subpages containing further subpages. Think of it as a hierarchical
representation, just like a file system. Every subpage is automatically linked back to the main page.

The current wiki page tree looks like this:

wiki.services.openoffice.org/wiki/Documentation
|
+---Dashboard
+---Administration Guide
+---FAQ
+---How Tos
+---OOoAuthors User Manual
+---OOo3 User Guides
+---Tutorials
+---Samples, Templates and Clipart
+---Setup Guide
+---BASIC Guide
+---Building Guide
+---DevGuide
+---Reference

{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
|-
!Subpage!!Description
|-
|[[Documentation/Dashboard]]
|High-level tracking of documentation sub-projects and content deliverables
|-
|[[Documentation/Administration Guide]]
|Guide that describes how to administer an OpenOffice.org network installation
|-
|[[Documentation/FAQ]]
|Collection of FAQs.
|-
|[[Documentation/How Tos]]
|Link collection of How Tos
|-
|[[Documentation/OOoAuthors User Manual]]
|Collection of OpenOffice.org 2.x User Guides from OOoAuthors
|-
|[[Documentation/OOo3 User Guides]]
|Collection of OpenOffice.org 3 User Guides from OOoAuthors
|-
|[[Documentation/Tutorials]]
|Tutorial collections from different contributors
|-
|[[Documentation/Samples, Templates and Clipart]]
|Sub-project page in order to provide usable templates for business and personal use (draft)
|-
|[[Documentation/Setup Guide]]
|Sub-project page in order to provide a guide through the setup process of OpenOffice.org (in progress)
|-
|[[Documentation/BASIC Guide]]
|Guide that provides an introduction to programming with OpenOffice.org BASIC
|-
|[[Documentation/Building Guide]]
|Guide that describes how to build the {{OOo}} software yourself, from source.
|-
|[[Documentation/DevGuide]]
|Guide that describes how to program with OpenOffice.org using the component technology UNO (Universal Network Objects) with OpenOffice.org.
|-
|[[Documentation/Reference]]
|Collection of reference material. References on this page should show up under '''Reference Lists''' at the Documentation main page.
|}

=Creating new Pages=

{{Documentation/Caution | Before creating a page make sure that there is not already an existing page with a similar topic.}}

* If the new page can be a subpage of an existing page simply go to the existing page and create a link to the new page. After saving the page with the link you can click the link and start writing on your new page.

* If you want to create a really new page for the Documentation project, you can use the wiki's URL for creating a new page. You should observe the wiki page tree when you create a new page in this way. The URL to a wiki page is then something like this: <tt><nowiki> http://wiki.services.openoffice.org/wiki/documentation/</nowiki>''Page Name''</tt>
* However, the recommended method is to search for the desired page name (in the Search field above left), and when the page does not exist, you will be offered to "create this page" by clicking on a link on the Search Results Page.

{{Documentation/Note | The URL approach is only useful if you link the page later to other pages. Otherwise it will be hidden in the wiki.}}

For more information about new pages see the [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Mediawiki help about new pages]

=Using Categories=

The Categories that are assigned to a page are usually listed at the bottom of the page. Click on a Category, and you will view a topic page with all the pages that have been classified in that Category. This way, a Category tag in a page gives you the opportunity to look up related contents. The bigger the page the more Category tags might be inserted

To add a Category tag to a page
# Click '''Special pages''' in the toolbox on the left side.
# Click '''Categories''' in the Special pages link list.
# Choose a Category name that makes sense, and apply it by adding <tt>[[Category:''Category Name'']]</tt> at the end of the page.

{{Documentation/Caution | Do not create duplicate Categories for the same topic. Each Category must be unique. Otherwise it will be difficult to use the Categories for searching the wiki.}}

Look at [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories] if you want to know more about Wiki Categories.

A simple example of how to use Categories in Wiki books:
# Create a Category named after the current chapter.
# Add the new Category tag to all pages of that chapter
# Add the Category tag for the book to the newly created Category page.

The reader can then view the book Category. The book Category shows all the chapters in the book. If the reader clicks on a chapter Category, they can see all of the pages in that chapter (in alphabetical order).

Do not add a category and its subcategory to the same wiki page. For more information see the MediaWiki Help:Category section on [http://meta.wikimedia.org/wiki/Help:Category#Category_considerations Category considerations].

You can use Templates to add a common category to a large group of pages, but it is not recommended. It may appear to save time, but "adding or deleting a category tag in the template does not add or delete the listings on the category page of pages that use the template, until some edit is made in the page that uses the template." For more information, see the MediaWiki Help:Category section on [http://meta.wikimedia.org/wiki/Help:Category#Using_templates_to_populate_categories Using templates to populate categories].

=Templates=

Look at the [http://www.mediawiki.org/wiki/Help:Templates Templates help] if you are unfamiliar with mediawiki templates.

==Adding a new Documentation Template==
<section begin=addingtemplate />
* If you create a new template to be used in the wiki documentation, name it as a subpage of '''Documentation'''.
** wrong: <tt>mytemplate</tt>
** right: <tt>Documentation/mytemplate</tt>

* Add a description of the template purpose and usage to the template itself using the <code><noinclude></code> element as described in [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template].

* Add the template to the list of templates below.
<section end=addingtemplate />
{{Spacer|30}}

== List of Existing Documentation Templates ==

<section begin="doctemplates" /> This is a list of Documentation templates and their usage

{| cellspacing="4" cellpadding="3" border="1" style="border-collapse: collapse;"
|-
! Template Name
! Usage
! Example
|-
| [[Template:Documentation/Banner]]
| Puts the Documentation Project "Banner" at the top right of the page
<tt><nowiki>{{Documentation/Banner}}</nowiki></tt>

| [[Image:Docbanner.png]]
|-
| [[Template:Documentation/OOo]]
| Displays an OpenOffice.org logo
<tt><nowiki>{{Documentation/OOo}}</nowiki></tt>

| {{Documentation/OOo}}
|-
| [[Template:Documentation/PDF]]
| <tt><nowiki>{{Documentation/PDF}}</nowiki></tt>
| {{Documentation/PDF}}
|-
| [[Template:Documentation/PRODUCTNAME]]
| A variable for displaying the string '''OpenOffice.org'''.
<tt><nowiki>{{Documentation/PRODUCTNAME}}</nowiki></tt>

| {{Documentation/PRODUCTNAME}}
|-
| [[Template:Documentation/hbar]]
| Used to draw horizontal bars for simplistic bar charts
<tt><nowiki>{{Documentation/hbar|width=100|bg=#3333FF}}</nowiki> <nowiki>{{Documentation/hbar|width=57|bg=#33FF33}}</nowiki> <nowiki>{{Documentation/hbar|width=112|bg=#FF3333}}</nowiki></tt>

|
{{Documentation/hbar|width=100|bg=#3333FF}} {{Documentation/hbar|width=57|bg=#33FF33}} {{Documentation/hbar|width=112|bg=#FF3333}}

|-
| [[Template:Documentation/BeingEdited]]
| Marks a page as currently being edited to avoid conflicting changes.
Use this template when you perform larger edits on a file that may even take more than one session to finish. Be sure to add name and date of "locking" by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter: <tt><nowiki>{{Documentation/BeingEdited|~~~~}}</nowiki></tt>

| {{Documentation/BeingEdited|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)}}
|-
| [[Template:Documentation/NeedsRework]]
| <tt><nowiki>{{Documentation/NeedsRework}}</nowiki></tt>
| {{Documentation/NeedsRework}}
|-
| [[Template:Documentation/HelpNeeded]]
| <tt><nowiki>{{Documentation/HelpNeeded|Check the spelling}}</nowiki></tt>
| {{Documentation/HelpNeeded|Check the spelling}}
|-
| [[Template:Documentation/CheckedAccuracy]]
| Marks up pages that have been reviewed for accuracy.
Be sure to add name and date of review by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter: <tt><nowiki>{{Documentation/CheckedAccuracy|~~~~}}</nowiki></tt>

| {{Documentation/CheckedAccuracy|John Doe 08:16, 22 January 2009 (UTC)}}
|-
| [[Template:Documentation/Outdated]]
| Identifies a page that is obsolete
<tt><nowiki>{{Documentation/Outdated}}</nowiki></tt>

| {{Documentation/Outdated}}
|-
| [[Template:Documentation/DraftPage]]
| Marks up pages that are in a draft state
<tt><nowiki>{{Documentation/DraftPage}}</nowiki></tt>

| {{Documentation/DraftPage}}
|-
| [[Template:Documentation/Imported]]
| <tt><nowiki>{{Documentation/Imported|author=Author Name|contributors=Contributor Names}}</nowiki></tt>
| {{Documentation/Imported|author=Author Name|contributors=Contributor Names}}
|-
| [[Template:Documentation/Windows]]
| Displays a Windows logo and allows to enter Windows specific content.
<tt><nowiki>{{Documentation/Windows|Windows related content}}</nowiki></tt>

| {{Documentation/Windows|Windows related content}}
|-
| [[Template:Documentation/Linux]]
| Displays a Linux logo and allows to enter Linux specific content.
<tt><nowiki>{{Documentation/Linux|Linux related content}}</nowiki></tt>

| {{Documentation/Linux|Linux related content}}
|-
| [[Template:Documentation/OSX]]
| Displays an Apple/OSX logo and allows to enter OSX specific content
<tt><nowiki>{{Documentation/OSX | Mac related content}}</nowiki></tt>

| {{Documentation/OSX | Mac related content}}
|-
| [[Template:Bug]]
| Links to Issuezilla issue.
<tt><nowiki>{{Bug|123456}}</nowiki></tt>

| {{Bug|123456}}
|-
| [[Template:Documentation/Note]]
| Takes sections containing notes,i.e. related, reinforcing information, for example, an explanation or comment.
<tt><nowiki>{{Documentation/Note|Notable stuff}}</nowiki></tt>

| {{Documentation/Note|Notable stuff}}
|-
| [[Template:Documentation/Tip]]
| Takes sections containing tips, i.e. useful non-crucial information, for example, a keyboard shortcut.
<tt><nowiki>{{Documentation/Tip|Right-click opens the context menu}}</nowiki></tt>

| {{Documentation/Tip|Right-click opens the context menu}}
|-
| [[Template:Documentation/Caution]]
| Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.
<tt><nowiki>{{Documentation/Caution|Always switch off power before opening the case.}}</nowiki></tt>

| {{Documentation/Caution|Always switch off power before opening the case.}}
|-
| [[Template:Documentation/SeeAlso]] and [[Template:Documentation/DevGuide/SeeAlso]]
| <tt><nowiki>{{Documentation/SeeAlso|
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
}}</nowiki></tt>
*DevGuide/SeeAlso version is used in the Developer's Guide and is set to be excluded from generated PDF and ODT books.

| {{Documentation/SeeAlso|
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
}}
|-
| [[Template:Documentation/FromForum]]
| <tt><nowiki>{{Documentation/FromForum}}</nowiki></tt>
| {{Documentation/FromForum}}
|-
| [[Template:Documentation/Abstract]]
| Takes a short abstract of the chapter content of guides. Add to the top of guides.
<tt><nowiki>{{Documentation/Abstract|Abstract Text}}</nowiki></tt>

| See, for example, [[Documentation/Administration Guide/Customizing|this Administration Guide Chapter]]
|-
| Template:Documentation/*TOC
| Several tables of content based on [[Template:Documentation/MasterTOC]] used in guides.
| See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
|-
| [[Template:Documentation/MasterTOC]]
| This is the master template that is used to create tables of content. For usage click the template name.
|
|-
| [[Template:Documentation/OOoVersion]]
| This template is used to insert an OpenOffice.org version box on a page.
<nowiki>{{Documentation/OOoVersion|1.1.x}}</nowiki>
| {{Documentation/OOoVersion|1.1.x}}
|-
| [[Template:OOoW]]
| This template is used to insert an '''{{OOoW}}''' string in text.
<nowiki>{{OOoW}}</nowiki> <nowiki>{{OOoW|1}}</nowiki>
| {{OOoW}} {{OOoW|1}}
|-
| [[Template:OOoC]]
| This template is used to insert an '''{{OOoC}}''' string in text.
<nowiki>{{OOoC}}</nowiki> <nowiki>{{OOoC|1}}</nowiki>
| {{OOoC}} {{OOoC|1}}
|-
| [[Template:OOoI]]
| This template is used to insert an '''{{OOoI}}''' string in text.
<nowiki>{{OOoI}}</nowiki> <nowiki>{{OOoI|1}}</nowiki>
| {{OOoI}} {{OOoI|1}}
|-
| [[Template:OOoD]]
| This template is used to insert an '''{{OOoD}}''' string in text.
<nowiki>{{OOoD}}</nowiki> <nowiki>{{OOoD|1}}</nowiki>
| {{OOoD}} {{OOoD|1}}
|-
| [[Template:OOoB]]
| This template is used to insert an '''{{OOoB}}''' string in text.
<nowiki>{{OOoB}}</nowiki> <nowiki>{{OOoB|1}}</nowiki>
| {{OOoB}} {{OOoB|1}}
|-
| [[Template:OOoM]]
| This template is used to insert an '''{{OOoM}}''' string in text.
<nowiki>{{OOoM}}</nowiki> <nowiki>{{OOoM|1}}</nowiki>
| {{OOoM}} {{OOoM|1}}
|-
| [[Template:SRB]]
| This template is used to insert an '''{{SRB}}''' string in text.
<nowiki>{{SRB}}</nowiki> <nowiki>{{SRB|1}}</nowiki>
| {{SRB}} {{SRB|1}}
|-
| [[Template:MSO]]
| This template is used to insert an '''Microsoft Office''' string in text.
<nowiki>{{MSO}}</nowiki>
| {{MSO}}
|-
| [[Template:MSO2003]]
| This template is used to insert an '''Microsoft Office 2003''' string in text.
<nowiki>{{MSO2003}}</nowiki> <nowiki>{{MSO2003|1}}</nowiki>
| {{MSO2003}} {{MSO2003|1}}
|-
| [[Template:MSO2010]]
| This template is used to insert an '''Microsoft Office 2010''' string in text.
<nowiki>{{MSO2010}}</nowiki> <nowiki>{{MSO2010|1}}</nowiki>
| {{MSO2010}} {{MSO2010|1}}
|-
| [[Template:MSW]]
| This template is used to insert an '''MS Word''' string in text.
<nowiki>{{MSW}}</nowiki> <nowiki>{{MSW|1}}</nowiki>
| {{MSW}} {{MSW|1}}
|-
| [[Template:MSE]]
| This template is used to insert an '''MS Excel''' string in text.
<nowiki>{{MSE}}</nowiki> <nowiki>{{MSE|1}}</nowiki>
| {{MSE}} {{MSE|1}}
|-
| [[Template:MSA]]
| This template is used to insert an '''MS Access''' string in text.
<nowiki>{{MSA}}</nowiki> <nowiki>{{MSA|1}}</nowiki>
| {{MSA}} {{MSA|1}}
|-
| [[Template:MSPP]]
| This template is used to insert an '''MS Power Point''' string in text.
<nowiki>{{MSPP}}</nowiki> <nowiki>{{MSPP|1}}</nowiki>
| {{MSPP}} {{MSPP|1}}
|-
| [[Template:MSEq]]
| This template is used to insert an '''MS Equation''' string in text.
<nowiki>{{MSEq}}</nowiki> <nowiki>{{MSEq|1}}</nowiki>
| {{MSEq}} {{MSEq|1}}
|-
| [[Template:Key]]
| This template is used to insert keycodes in text.
<nowiki>{{Key|Ctrl|Shift|>}}</nowiki>
| {{Key|Ctrl|Shift|>}}
|-
| [[Template:QuoteEn]]
| The template is designed for inserting quotations in the text.
<nowiki>{{QuoteEn</nowiki> 
<nowiki> |quote=</nowiki> 
<nowiki> |author=</nowiki> 
<nowiki> }}</nowiki>
| {{QuoteEn
|quote=OpenOffice.org 3 is the leading open-source office software suite for word processing, spreadsheets, presentations, graphics, databases and more.
|author=why.openoffice.org
}}
|-
| [[Template:Menu]]
| This template is designed to insert text anywhere in the chain menu.
{{RUcode|25|<nowiki>{{Menu|File|Open|Print|4|5|6|7|8|9|10}}</nowiki>}}
| {{Menu|File|Open|Print|4|5|6|7|8|9|10}}

|}

<section end="doctemplates" />

=Graphical Content=

General guidelines for images are:
* Use a descriptive and unique title. The filename should be constructed in a way so it shows the usage, e.g. Doc_mig_icon_data.png = '''Doc'''umentation image, used in the '''mig'''ration guide, depicting the '''data'''base '''icon'''.
* If possible, do not pre-scale the images you are uploading. You can use the MediaWiki image thumbnail feature to scale the image.
* Edit the image if necessary to make sure that the important part is clear and visible.
* Keep in mind that people may be translating the page where you are placing an image. Try not to include callouts or other extra text on the image.
* JPG is usually best for photos, SVG, for icons, logos etc, and PNG for screen captures. Try not to use BMP.

Before you can insert your well prepared image in a wiki page you have to upload it.
# In the sidebar, under '''toolbox''', click '''Upload file'''. The image description page will appear.
# Use the image description page to describe an image and copyright status (if any).

To place the image on a page you can use the MediaWiki Image thumbnail feature which "wraps" your illustrations in an image box. This image box includes a spot for an image caption. The syntax is <tt>[[Image:''image.png|thumb|position|size|Image caption'']]</tt>, where:
* thumb = thumbnail the image and wrap in an image box
* position = position on page. "none" places the image on the left of the frame with no text wrapping. "left" and "right" places the image on the left or right of the page with full text wrapping.
* size = max width in pixels for the image. If the image is larger than this value it is scaled down. If the image is smaller it is left as is.
If you do not declare a position and size, the image is scaled to a small thumbnail, and defaults to the right hand side of the page with full text wrapping.

Here is an example using <tt><nowiki>[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]</nowiki></tt>

[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]

* How to handle image and table numbering?

=Linking=

Although the editing window offers assistence in writing internal and external links look at the [http://www.mediawiki.org/wiki/Help:Links MediaWiki help page about links] for a better understanding of how links are working in wikis.

There is another MediaWiki help page if you need some [http://meta.wikimedia.org/wiki/Help:Wikitext_examples#Links examples].

When creating link text consider the guidelines for [[Documentation/Dashboard/Help_Style_Guide#Using_Links | using links]] in our style guide.

=General Editing Work=

Editing is only possible after login. You can start editing the whole page after clicking the '''edit''' tab at the top. But usually it is more comfortable to edit individual sections of a page by clicking one of the '''[edit]''' links on the right side. If you make changes, please consider the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]] to assure a consistent writing style. Click the '''Show preview''' button before you save the page finally.

== Fixing inappropriate, inaccurate, or outdated content ==

Contents that are not up to date are usually marked by one of the following labels:

{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
|- valign=top
| {{Documentation/Outdated}}
| This label means that an article is outdated as a whole and needs to be revised completely.
|- valign=top
| {{Documentation/HelpNeeded|works for OOo 2, needs to be confirmed for OOo 3}}
| If an article is partly outdated or inaccurate you may find this label asking for specific help.
|- valign=top
| {{Documentation/NeedsRework}}
| You can find a collection of pages with this label if you click on [[:Category:Documentation/NeedsRework|Pages that Need Help! ]] on the Wiki main page.
|}

When you have selected a page to work on

#test whether the described procedures are still valid for the current version of OpenOffice.org.
#log in and make the necessary corrections.

This works best when you open two tabs in the browser, one for reading the procedures and another for editing.

When you have finished, remove the above label(s), mark the page with the label "Checked for technical accuracy" (as described in the [[Documentation/Dashboard/Wiki Editing Policy#List_of_Existing_Documentation_Templates|Templates]] section above), and click '''Save page'''.

==Fixing minor errors and typos==

If you detect minor errors like typos, just log in and edit the article. Before clicking on the '''Save page''' button you might check the '''This is a minor edit''' box above.

==Fixing graphics and screenshots==

To edit a graphic in the wiki, right-click the graphic and choose '''Save image as'''. When you have edited the graphic on your computer, go back to the wiki page, click the graphic, and in the image description page choose '''Upload a new version of this file'''.

If you have created a new version of a screenshot, directly click the corresponding screenshot in the wiki and then '''Upload a new version of this file''' in the image description page.

==Fixing Style and Language==

Articles that need improvement in style and language might be recognized by the following labels:
{{Documentation/HelpNeeded|Check the spelling}}
{{Documentation/NeedsRework}}
You can find a collection of articles with the latter label if you click on [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] on the Wiki main page.

To improve such an article, just log in, click on the edit tab and make the necessary corrections. Then remove the label(s) and click on '''Save page'''.

==Linking to localized pages==

* Link the various languages to each other using the Interwiki links syntax <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. For example, <tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt> adds a link to the Chinese translation of the first page of the Developer's Guide. This link shows in the left column, under the heading "In other languages". This may be more practical to do with Wiki Templates as more languages are added.
* In the Developer's guide we use a template to link translated pages. The Wiki Syntax is: <tt><nowiki>
{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt> where Page_Title is the current Wiki page name. For example, <tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org
Developers Guide}}</nowiki></tt> will add the localized page links for the first page in the Developer's Guide. If you want to see a link to your language at the Developer's Guide wiki pages simply add your language to the template [[Template:Documentation/DevGuideLanguages]]. For example, for Dutch you would have to add <tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>. Make sure the template is referenced correctly in each of the translated pages.

==Validating Content==

==Fixing Spam / Deleting Pages==

If you detect spam you can send a mail to [mailto:dev@website.openoffice.org dev@website.openoffice.org].

There is also a [[Special:Listusers/sysop|list with Wiki Sysops]] (people who can delete pages). If you want to have pages deleted, you can either ask someone from that list, or better, add the Wiki Syntax <tt><nowiki>{{delete}}</nowiki></tt> anywhere on the page you want to be deleted. This will add the page to the "Candidates for speedy deletion" category, and the page will be deleted by someone with Sysop privileges, or by WikiBot maintenance.

=Working on FAQs=
Every question together with its answer is displayed on one single wiki page.

If you want to insert a new FAQ entry, that is, a pair of a question together with the corresponding answer:
<ol>
<li> Select a FAQ section on the main page of the Documentation Wiki. In Writer and Calc you have to select another subpage until you reach a final FAQ section.</li>
<li> Scroll down to the Insert New FAQ listbox.</li>
<li> Replace the text in the listbox after the last slash '/' with your question.</li>
<li> Click '''Add New FAQ''' A new wiki page will be created and preloaded with a template for a Q/A pair:

<source lang="text">
{{{DISPLAYTITLE: (INSERT FAQ TITLE)}}

<section begin=question/>
<INSERT QUESTION>
<section end=question/>

<section begin=answer/>
<INSERT ANSWER>
<section end=answer/>

[[Category:Documentation/FAQ/<INSERT FAQ SECTION>]]

</source>

</li>

<li> Replace <tt>(INSERT FAQ TITLE)</tt> with the title of the FAQ to be displayed on the page. This may be a short version of the question or the question itself.</li>
<li> Replace <tt><INSERT QUESTION></tt> with the actual question.</li>
<li> Replace <tt><INSERT ANSWER></tt> with the actual answer.</li>
<li> Replace <tt><INSERT FAQ SECTION></tt> with the current FAQ section name. This category assignment determines where this wiki page will appear. Please use the following section names:</li>

{|class="prettytable sortable"
|-
!FAQ section !!section name in category
|-valign=top
|General||General
|-valign=top
|Installation||Installation
|-valign=top
|Word Processing||Writer
|-valign=top
|Automatic Functions||Writer/AutomaticFunctions
|-valign=top
|Document Management||Writer/DocumentManagement
|-valign=top
|Formatting Pages and Docs||Writer/FormattingPagesAndDocuments
|-valign=top
|Formatting Text||Writer/FormattingText
|-valign=top
|Graphics, Frames & Objects||Writer/GraphicsFramesObjects
|-valign=top
|Indexes, Tables of Contents||Writer/IndexToc
|-valign=top
|Printing and Mail Merge||Writer/Printing
|-valign=top
|Spreadsheets||Calc
|-valign=top
|Drawings||Draw
|-valign=top
|Presentations||Impress
|-valign=top
|Formula Editor||Formula
|-valign=top
|Database||Databases
|-valign=top
|Macros||Macros
|}
<li>Click '''Save Page'''.</li>
</ol>

=Working on How Tos=
If you want to create a new How To
# Go to the [[Documentation/How_Tos | How Tos section]] and open the edit window.
# Identify the adequate subsection and enter the title of your How To as a link.
# Click '''Save Page''' to make the link visible.
# Click the link to your How To and start writing by using the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]]. If you are not sure about how to implement the style guide, have a look at the Writer How To [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].

{{Documentation/Note|Always put the licence link at the end of your article: Simply insert <tt><nowiki>{{PDL1}}</nowiki></tt>. }}

You can also create How Tos by writing a new page like <tt>Documentation/How Tos/''Page Name''</tt> with one or more specific categories. The newly created How To page will then be assigned to the corresponding How To sections. The available categories for that are the following:
* <tt><nowiki>[[Category:Documentation/How Tos/Installation]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Writer]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Impress]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Calc]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Database]]</nowiki></tt>

If you want to revise existing How Tos, watch for the label "This article needs to be checked for accuracy and style."
* Test whether the described procedures are still valid for the current version of OpenOffice.org,
* check whether the rules of the style guide are applied,
* check for grammar and spelling mistakes,
and make the necessary corrections in the edit window.

When you have finished, mark the page with the label "Checked for technical accuracy" as described in the [[Documentation/Dashboard/Wiki_Editing_Policy#List_of_Existing_Documentation_Templates | Templates]] section above, and click '''Save page'''.

Do not forget to notify [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] about your work on the How Tos.

=Working on Guides=
Currently, there are the following guides on the wiki:
* [[Documentation/Administration_Guide|The Administration Guide]]
* [[Documentation/BASIC_Guide|The BASIC Programming Guide]]
* [[Documentation/Building_Guide|The Building Guide (OO.o from source)]]
* [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|The Developer's Guide]]
* [[Documentation/OOoAuthors_User_Manual|The User Guides for OpenOffice.org 2.x]]
* [[Documentation/OOo3_User_Guides|The User Guides for OpenOffice.org 3.x]]

If you want to work on the User Guides for OpenOffice.org please contact the [http://www.oooauthors.org OOoAuthors group].

There is some help available about [[Documentation/DevGuide/Contributing_to_the_Developers_Guide|Contributing to the Developer's Guide]] which may also be useful for the Administration Guide and the BASIC Programming Guide.

=Localizing Content=

{{#lst:Help:Translating|translating}}

{{PDL1}}

[[Category:Help]]
[[Category:How to]]
[[Category:Guidelines]]
[[Category:Localization]]
[[Category:Documentation/Dashboard]]

Template:QuoteRu

2010-07-05T14:24:39Z

Aeroshin:

<blockquote style="margin:2px 2em;  background:#f0f3fc; border:0px solid gray; color:#333;">{{{цитата|[[File:Quote bg.png]]{{{1}}}[[File:Quote bg2.png]]}}}{{#if:{{{автор|{{{2|}}}}}}|     {{{автор|{{{2}}}}}}}}</blockquote><noinclude>
[[Category:RU/wiki templates]]
</noinclude>

RU/kb/50000006

2010-06-18T09:28:19Z

Aeroshin: измененно построение фраз

{{DISPLAYTITLE:База Знаний: Base. "Неожиданная ошибка" при закрытии приложения}}
[[RU/kb/base_errors|База Знаний: Base. Ошибки]]
__NOTOC__

"Неожиданная ошибка" при работе с Base, в различных ситуациях, может возникать если:
* в настройках {{OOo}} полностью отключено использование Java-машины;
* установлена Java от стороннего производителя, а не от Oracle (Sun).

Для проверки следует войти в меню '''Сервис''' → '''Параметры''' → '''OpenOffice.org''' → '''Java'''.

[[RU/kb/index/50|Индекс: Base]]

{{RU/documentation/sign|Sancho|А. Е. Харламенков}}
{{RU/documentation/oooversion|2.3}}
{{KbBaseBottom}}

RU/qa/vcltesttool

2010-05-23T00:34:52Z

Aeroshin: /* Дополнительные ссылки */

{{RU/documentation/helpneeded|Проверка и уточнение перевода на русский язык}}
{{DISPLAYTITLE:Контроль качества: VCLTesttool}}
[[en:VCLTesttool]]
[[ko:KO/VCLTesttool]]
[[sl:SL/VCLTestTool]]

{{RU/vcltesttool/vcltesttooltoc
|ShowPrevNext=none
|ShowPrevPage=none
|ShowNextPage=RU/qa/vcltesttool/introduction
|ShowNextPart=none
|ShowPrevPart=none
|NextPage=RU/qa/vcltesttool/introduction
|parttitle=[[Apendix]]
}}
== О VCLTesttool ==

VCLTesttool - это отдельная программа, которая используется для тестирования {{OOo}}. VCLTesttool взаимодействует с {{OOo}} через TCP/IP сокеты и может проверить каждую установку {{OOo}} на ПК. На текущий момент доступны версии [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html VCLTesttool для нескольких версий], от {{OOo}} 1.1beta и выше. Крайне желательно следить за выходом новых версий VCLTestTool, чтобы исключить ошибки из-за несовместимости утилиты и {{OOo}}

== Быстрый старт ==

Если вы хотите помочь в автоматизированном тестировании и начать немедленно, то данное руководство является вашим правильным выбором. Здесь представлено пошаговое руководство для начала тестирования OpenOffice.org-версий 3.x. Однако, это руководство будет полезно также и для начинающих, и для опытных тестеров.

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

===== CVS/SVN =====
Вы должны иметь рабочую CVS или SVN (мигрировать на SubVersion для запуска милстоуна DEV300_m32) в своей системе. Прочтите про [http://qa.openoffice.org/servlets/ProjectSource клиента CVS [en]] и его настройку для использования с OpenOffice.org. Прочтите про [[OOo_and_Subversion|использование SubVersion [en]]] с OpenOffice.org.

По окончании автоматического тестирования необходимо [[VCLTesttool#VCLTesttool_framework_.28testautomation.29|извлечь его результаты и заархивировать их [en]]].

===== OpenOffice.org =====
У вас должен быть установлен OpenOffice.org, при этом чрезвычайно знать его точную версию перед началом тестирования.

Если вы не уверены, какая версия установлена в вашей системе, то это можно проверить.

Для этого нужно открыть файл

{{Documentation/Linux| '''.versionrc''' (UNIX-Systems)}}
или
{{Documentation/Windows| '''version.ini''' (Windows-Systems)}}

в каталоге установки 
(смотрите в <INSTALLDIR>/OpenOffice.org 3/program)

Откройте этот файл и просмотрите раздел '''[Version]''':

Например:

ProductMajor=300
ProductMinor=29
ProductSource=DEV300

===== Система VCLTesttool (автоматизированное тестирование =====

Рамках VCLTesttool имеются все сценарии для тестирования милстоуна на основе текущих ответвлений и находящихся в CVS/SVN модулей '''автоматических тестов'''. Вы можете найти все эти файлы в OpenOffice.org CVS/SVN и легко загрузить их на вашей локальной файловой системе с помощью отладчика CVS/SVN.

Допустим, вы собираетесь протестировать версию на основе 'DEV300' c милстоуна 'm29'.

'''Помните, все DEV300 до милстоуна m32 находятся в CVS и все милстоуны от m32 на находятся в SVN.'''

Используйте следующую команду, чтобы получить исходники:

<TT>cvs checkout -r DEV300_m29 -d testautomation_m29 testautomation</TT> 
(опциональный параметр '''-d''' используется для проверки в указанном каталоге, чтобы иметь возможность провести несколько версий параллельно.)

Проверка через SubVersion:

<TT>svn checkout svn://svn.services.openoffice.org/ooo/tags/DEV300_m32/testautomation testautomation_m32</TT>

Если вы не хотите использовать CVS или SVN, то вы можете скачать архив автоматических тестов, созданный [http://accc.riken.jp/maho/ Наката Махо] из Good Day server. Просто [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/|скачайте архив для прохождения тестирования] вашей версии OpenOffice.org.

===== VCLTestTool =====
Для того, чтобы начать автоматическое тестирование OpenOffice.org вы должны иметь локальную копию VCLTesttool, установленную в вашей системе. [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать текущую версию VCLTesttool] соответствующую вашей ОС на ваш локальный компьютер, и распакуйте архив в вашей локальной системе. После извлечения файлов запустите в первый раз файл

{{Documentation/Linux| '''testtool.bin'''}}
{{Documentation/Windows| '''testtool.exe'''}}

После запуска VCLTesttool перейдите в меню '''Tools → Options'''.

'''(Все надписи на скриншотах приведены только как примеры. Адаптируйте их под свою ситуацию.)'''

* Вкладка '''"Profile"'''

[[Image: Testtool-option-profile.jpg]]

Необходимо создать профиль для автоматических тестов. Для этого введите:

#'''Profile''': DEV300m29
#'''Log base directory''': (Все результитующие файлы выполненных тестов будут сохраняться здесь.)
#'''Base directory''': Каталог извлечённых скриптов автоматического тестирования.
#'''Default HID directory''' устанавливается [[VCLTesttool/hid.lst_file |автоматически]] и, в большинстве случаев, не должен изменяться.

* Вкладка '''"Crashreport"'''

[[Image: Testtool-option-crashreport.jpg]]

Щёлкните '''"Allow contact"''' для установки флажка '''"Разрешить контакт"''' и введите действующий адрес электропочты OpenOffice.org в поле '''"EMail"'''. Этот адрес будет использоваться VCLTesttool для отсылки креш-репортов. Позже, когда вы ознакомитесь с автоматическими тестами, вы сможете добавлять результаты в [[QUASTe]] (Quality Assurance Statuspage), для чего действующий адрес электропочты имеет важное значение.

* Вкладка '''"Misc"'''

[[Image: Testtool-option-misc.jpg]]

На этой вкладке вы можете установить параметры связи VCLTesttool с OpenOffice.org. В большинстве случаев эти параметры оставляются по умолчанию. Если VCLTesttool не может запустить установленный OpenOffice.org, значит, что '''"Testtool Port"''' или '''"Remote UNO Port"''' заблокированы или защищены в вашей системе.
'''"OOo Program Dir"''' может быть указан каталог установки вашего OpenOffice.org. В большинстве случаев это поле должно оставаться пустым, так как VCLTesttool должен быть в состоянии найти установленный OpenOffice.org. Если нет, то вы можете указать здесь путь установки. Например:
<INSTALLDIR>/OpenOffice.org 3/program

Все ваши настройки VCLTestTool сохраняет в:

{{Documentation/Linux| '''${HOME}/.testtoolrc''' (UNIX-Systems)}}
или
{{Documentation/Windows| '''%APPDATA%\testtool.ini''' (Windows-Systems)}}
или
{{Documentation/OSX | '''$HOME/Library/Application Support/.testtoolrc''' (Mac OS X)}}

Щёлкните кнопку '''[OK]''' для сохранения настроек и выхода из VCLTestTool.

Теперь вся подготовка завершена.

== Запуск отдельного автоматического теста ==

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

Вся необходимая дополнительная информация о том, как должны завершаться автоматические тесты, находится в [[QUASTe#Category_model|QUASTe]].

* Запустите VCLTesttool и выбирете из меню '''File → Open''';
* выберите файл с расширением '''*.bas''';
* выберите каталог со скриптами тестов;
* выберите '''*.bas-файл''' для запуска следующего;
* нажмите '''[OK]''' в диалоге выбора файлов;
* нажмите '''[F5]''' или выберите из меню 'Program → start' для запуска автоматического теста.

Теперь остаётся только ждать завершения теста, и по его окончании проанализировать '''*.res-файл'''.

== Как скормить QUASTу результаты тестов ==

Чтобы скормить [[QUASTe|QUASTу]] результаты, вы должны добавить две строки в файл
{{Documentation/Linux| '''~/.testtoolrc'''}}

[Others]
PCname=<Name of the maschine>

== Вопросы, касающихся автоматических тестов ==

Во всех вопросах по автоматическим тестам, чтобы их могла обработать Группа Автоматического тестирования, необходимо указывать:

* '''Component''': qa
* '''Subcomponent''': testscripts
* '''assigned to''': automat@openoffice.org
* Резюме должно начинаться со слова '''[Automation]''' в квадратных скобках, и следом, так же в квадратных скобках, имя скрипта теста (например '''[w_updt.bas]''')

Кроме того, если вы знаете ответственного за автоматический тест (автора), то адресоваться можно напрямую к нему. [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview Список автоматических тестов и их ответственных] в [http://quaste.services.openoffice.org QUASTe].

== Известные проблемы, связанные со сценариями автоматизированных тестов ==

* Переключение документа для редактирования в режиме (слот: "EditDoc", StandardBar кнопка "Bearbeiten"): Когда документ загружается только для чтения у нас нет возможности для определения, активирована ли кнопка "Редактировать документ" и работает, или она в режиме "не используется". Некоторые странности обхода в реализации '''t_doc2.inc::sMakeReadOnlyDocumentEditable()''', которые не всегда работают. В графических модулей другие методы реализованы, но они не являются общими и не всегда обрабатывают возможные окна сообщений (messagebox).

== Дополнительные ссылки ==

# [[Run_OOo_versions_parallel]]
# [[RU/qa/automatic_testing]]

[[Category:Quality_Assurance]]
[[Category:TestAutomation]]

{{RU/documentation/signtransyear|Sancho|А. Е. Харламенков|2010}}

{{QaBottom}}

RU/qa/vcltesttool

2010-05-23T00:32:12Z

Aeroshin: Редактура текста / Editing text

{{RU/documentation/helpneeded|Проверка и уточнение перевода на русский язык}}
{{DISPLAYTITLE:Контроль качества: VCLTesttool}}
[[en:VCLTesttool]]
[[ko:KO/VCLTesttool]]
[[sl:SL/VCLTestTool]]

{{RU/vcltesttool/vcltesttooltoc
|ShowPrevNext=none
|ShowPrevPage=none
|ShowNextPage=RU/qa/vcltesttool/introduction
|ShowNextPart=none
|ShowPrevPart=none
|NextPage=RU/qa/vcltesttool/introduction
|parttitle=[[Apendix]]
}}
== О VCLTesttool ==

VCLTesttool - это отдельная программа, которая используется для тестирования {{OOo}}. VCLTesttool взаимодействует с {{OOo}} через TCP/IP сокеты и может проверить каждую установку {{OOo}} на ПК. На текущий момент доступны версии [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html VCLTesttool для нескольких версий], от {{OOo}} 1.1beta и выше. Крайне желательно следить за выходом новых версий VCLTestTool, чтобы исключить ошибки из-за несовместимости утилиты и {{OOo}}

== Быстрый старт ==

Если вы хотите помочь в автоматизированном тестировании и начать немедленно, то данное руководство является вашим правильным выбором. Здесь представлено пошаговое руководство для начала тестирования OpenOffice.org-версий 3.x. Однако, это руководство будет полезно также и для начинающих, и для опытных тестеров.

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

===== CVS/SVN =====
Вы должны иметь рабочую CVS или SVN (мигрировать на SubVersion для запуска милстоуна DEV300_m32) в своей системе. Прочтите про [http://qa.openoffice.org/servlets/ProjectSource клиента CVS [en]] и его настройку для использования с OpenOffice.org. Прочтите про [[OOo_and_Subversion|использование SubVersion [en]]] с OpenOffice.org.

По окончании автоматического тестирования необходимо [[VCLTesttool#VCLTesttool_framework_.28testautomation.29|извлечь его результаты и заархивировать их [en]]].

===== OpenOffice.org =====
У вас должен быть установлен OpenOffice.org, при этом чрезвычайно знать его точную версию перед началом тестирования.

Если вы не уверены, какая версия установлена в вашей системе, то это можно проверить.

Для этого нужно открыть файл

{{Documentation/Linux| '''.versionrc''' (UNIX-Systems)}}
или
{{Documentation/Windows| '''version.ini''' (Windows-Systems)}}

в каталоге установки 
(смотрите в <INSTALLDIR>/OpenOffice.org 3/program)

Откройте этот файл и просмотрите раздел '''[Version]''':

Например:

ProductMajor=300
ProductMinor=29
ProductSource=DEV300

===== Система VCLTesttool (автоматизированное тестирование =====

Рамках VCLTesttool имеются все сценарии для тестирования милстоуна на основе текущих ответвлений и находящихся в CVS/SVN модулей '''автоматических тестов'''. Вы можете найти все эти файлы в OpenOffice.org CVS/SVN и легко загрузить их на вашей локальной файловой системе с помощью отладчика CVS/SVN.

Допустим, вы собираетесь протестировать версию на основе 'DEV300' c милстоуна 'm29'.

'''Помните, все DEV300 до милстоуна m32 находятся в CVS и все милстоуны от m32 на находятся в SVN.'''

Используйте следующую команду, чтобы получить исходники:

<TT>cvs checkout -r DEV300_m29 -d testautomation_m29 testautomation</TT> 
(опциональный параметр '''-d''' используется для проверки в указанном каталоге, чтобы иметь возможность провести несколько версий параллельно.)

Проверка через SubVersion:

<TT>svn checkout svn://svn.services.openoffice.org/ooo/tags/DEV300_m32/testautomation testautomation_m32</TT>

Если вы не хотите использовать CVS или SVN, то вы можете скачать архив автоматических тестов, созданный [http://accc.riken.jp/maho/ Наката Махо] из Good Day server. Просто [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/|скачайте архив для прохождения тестирования] вашей версии OpenOffice.org.

===== VCLTestTool =====
Для того, чтобы начать автоматическое тестирование OpenOffice.org вы должны иметь локальную копию VCLTesttool, установленную в вашей системе. [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать текущую версию VCLTesttool] соответствующую вашей ОС на ваш локальный компьютер, и распакуйте архив в вашей локальной системе. После извлечения файлов запустите в первый раз файл

{{Documentation/Linux| '''testtool.bin'''}}
{{Documentation/Windows| '''testtool.exe'''}}

После запуска VCLTesttool перейдите в меню '''Tools → Options'''.

'''(Все надписи на скриншотах приведены только как примеры. Адаптируйте их под свою ситуацию.)'''

* Вкладка '''"Profile"'''

[[Image: Testtool-option-profile.jpg]]

Необходимо создать профиль для автоматических тестов. Для этого введите:

#'''Profile''': DEV300m29
#'''Log base directory''': (Все результитующие файлы выполненных тестов будут сохраняться здесь.)
#'''Base directory''': Каталог извлечённых скриптов автоматического тестирования.
#'''Default HID directory''' устанавливается [[VCLTesttool/hid.lst_file |автоматически]] и, в большинстве случаев, не должен изменяться.

* Вкладка '''"Crashreport"'''

[[Image: Testtool-option-crashreport.jpg]]

Щёлкните '''"Allow contact"''' для установки флажка '''"Разрешить контакт"''' и введите действующий адрес электропочты OpenOffice.org в поле '''"EMail"'''. Этот адрес будет использоваться VCLTesttool для отсылки креш-репортов. Позже, когда вы ознакомитесь с автоматическими тестами, вы сможете добавлять результаты в [[QUASTe]] (Quality Assurance Statuspage), для чего действующий адрес электропочты имеет важное значение.

* Вкладка '''"Misc"'''

[[Image: Testtool-option-misc.jpg]]

На этой вкладке вы можете установить параметры связи VCLTesttool с OpenOffice.org. В большинстве случаев эти параметры оставляются по умолчанию. Если VCLTesttool не может запустить установленный OpenOffice.org, значит, что '''"Testtool Port"''' или '''"Remote UNO Port"''' заблокированы или защищены в вашей системе.
'''"OOo Program Dir"''' может быть указан каталог установки вашего OpenOffice.org. В большинстве случаев это поле должно оставаться пустым, так как VCLTesttool должен быть в состоянии найти установленный OpenOffice.org. Если нет, то вы можете указать здесь путь установки. Например:
<INSTALLDIR>/OpenOffice.org 3/program

Все ваши настройки VCLTestTool сохраняет в:

{{Documentation/Linux| '''${HOME}/.testtoolrc''' (UNIX-Systems)}}
или
{{Documentation/Windows| '''%APPDATA%\testtool.ini''' (Windows-Systems)}}
или
{{Documentation/OSX | '''$HOME/Library/Application Support/.testtoolrc''' (Mac OS X)}}

Щёлкните кнопку '''[OK]''' для сохранения настроек и выхода из VCLTestTool.

Теперь вся подготовка завершена.

== Запуск отдельного автоматического теста ==

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

Вся необходимая дополнительная информация о том, как должны завершаться автоматические тесты, находится в [[QUASTe#Category_model|QUASTe]].

* Запустите VCLTesttool и выбирете из меню '''File → Open''';
* выберите файл с расширением '''*.bas''';
* выберите каталог со скриптами тестов;
* выберите '''*.bas-файл''' для запуска следующего;
* нажмите '''[OK]''' в диалоге выбора файлов;
* нажмите '''[F5]''' или выберите из меню 'Program → start' для запуска автоматического теста.

Теперь остаётся только ждать завершения теста, и по его окончании проанализировать '''*.res-файл'''.

== Как скормить QUASTу результаты тестов ==

Чтобы скормить [[QUASTe|QUASTу]] результаты, вы должны добавить две строки в файл
{{Documentation/Linux| '''~/.testtoolrc'''}}

[Others]
PCname=<Name of the maschine>

== Вопросы, касающихся автоматических тестов ==

Во всех вопросах по автоматическим тестам, чтобы их могла обработать Группа Автоматического тестирования, необходимо указывать:

* '''Component''': qa
* '''Subcomponent''': testscripts
* '''assigned to''': automat@openoffice.org
* Резюме должно начинаться со слова '''[Automation]''' в квадратных скобках, и следом, так же в квадратных скобках, имя скрипта теста (например '''[w_updt.bas]''')

Кроме того, если вы знаете ответственного за автоматический тест (автора), то адресоваться можно напрямую к нему. [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview Список автоматических тестов и их ответственных] в [http://quaste.services.openoffice.org QUASTe].

== Известные проблемы, связанные со сценариями автоматизированных тестов ==

* Переключение документа для редактирования в режиме (слот: "EditDoc", StandardBar кнопка "Bearbeiten"): Когда документ загружается только для чтения у нас нет возможности для определения, активирована ли кнопка "Редактировать документ" и работает, или она в режиме "не используется". Некоторые странности обхода в реализации '''t_doc2.inc::sMakeReadOnlyDocumentEditable()''', которые не всегда работают. В графических модулей другие методы реализованы, но они не являются общими и не всегда обрабатывают возможные окна сообщений (messagebox).

== Дополнительные ссылки ==

# [[Run_OOo_versions_parallel]]

[[Category:Quality_Assurance]]
[[Category:TestAutomation]]

{{RU/documentation/signtransyear|Sancho|А. Е. Харламенков|2010}}

{{QaBottom}}

RU/qa/automatic testing

2010-05-23T00:23:05Z

Aeroshin: Изменено форматирование / Changed formatting

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из [http://hg.services.openoffice.org/ репозитария с исходным кодом Mercurial].

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320m17''' или '''DEV300m78'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe] (ссылка на загрузку в самом низу страницы).
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения:

{{Documentation/Linux|'''testtool.bin'''}}
или
{{Documentation/Windows|'''testtool.exe'''}}

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
:''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - '''Директория журналирования''' - каталог для результатов тестирования
:''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* '''Базовая директория''' - каталог с набором автоматических тестов
:''/home/user/DEV300_m75/testautomation''

{{Documentation/Linux|'''Для *nix платформ необходимо вручную указать имя машины.'''

* Открываем файл настроек текстовым редактором, обычно расположен ${HOME}/.testtoolrc,
* Добавляем в конец следующие строки:
[Others]
<nowiki>PCname=<имя машины></nowiki>}}

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл
{{Documentation/Linux|'''run_tests.sh''' применяется для UNIX платформ,}}
{{Documentation/Windows|'''run_tests.vbs''' используется для Windows.}}

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге 
''./testautomation/global/hid/'' 
После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

{{Documentation/Note|ВАЖНО!: Для каждой сборки файл hid.lst уникален.}}

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTe], перейдя в раздел «View Autotests», и выбрав соответствующую сборку и платформу.

=== Перечень тестов ===
Скачанный перечень тестов из [http://quaste.services.openoffice.org/ странице QUASTe] необходимо привести в пригодное для ''run_test'' состояние.
Для этого необходимо открыть его обычным тестовым редактором (например gedit):
* Удалить пробел в каждой строке после ''.bas''. Проще всего это сделать заменой ".bas " на ".bas"
* Удалить служебную информацию, такую как информацию о релизе и категории тестов.

В результате файл должен содержать только список тестов с путями к ним.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен {{OOo}} и удалён [[RU/kb/70000005|профиль {{OOo}}]] (в этом случае каталог Профиля будет иметь то же имя, что и каталог установки {{OOo}}).
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом. Затем запускаем
{{Documentation/Linux|'''run_tests.sh'''}}
{{Documentation/Windows|'''run_tests.vbs''' для Windows}}

Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например:
{{Documentation/Linux|'''''./run_tests.sh < /home/user/DEV300_m75/tests.txt'''''}}
{{Documentation/Windows|'''''cscript run_tests.vbs < C:\DEV300_m75/tests.txt''''' для Windows}}

* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: <source lang="bash">perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res</source>
В консоль выводится итоговая таблица.

Можно перенаправить в файл: <source lang="bash">perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt</source>

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org и наборы автоматических тестов.



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в <del>CVS/SVN</del> [http://download.services.openoffice.org/files/extended/ http://download.services.openoffice.org/files/extended/], но уже содержит внутри файл hid.lst .

|-
| <nowiki>http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&workspace=</nowiki>DEV300&milestone=m77&download=2
| Файл hid.lst для помещения в папку testautomation/global/hid

|}

{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{QaBottom}}

RU/qa/automatic testing

2010-05-22T23:55:37Z

Aeroshin: Добавлена информация о перечне автотестов / Added info about autotest list from QUASTe.

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из [http://hg.services.openoffice.org/ репозитария с исходным кодом Mercurial].

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320m17''' или '''DEV300m78'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe] (ссылка на загрузку в самом низу страницы).
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения:

{{Documentation/Linux|'''testtool.bin'''}}
или
{{Documentation/Windows|'''testtool.exe'''}}

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
:''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - '''Директория журналирования''' - каталог для результатов тестирования
:''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* '''Базовая директория''' - каталог с набором автоматических тестов
:''/home/user/DEV300_m75/testautomation''

{{Documentation/Linux|'''Для *nix платформ необходимо вручную указать имя машины.'''

* Открываем файл настроек текстовым редактором, обычно расположен ${HOME}/.testtoolrc,
* Добавляем в конец следующие строки:
[Others]
<nowiki>PCname=<имя машины></nowiki>}}

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл
{{Documentation/Linux|'''run_tests.sh''' применяется для UNIX платформ,}}
{{Documentation/Windows|'''run_tests.vbs''' используется для Windows.}}

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге 
''./testautomation/global/hid/'' 
После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

{{Documentation/Note|ВАЖНО!: Для каждой сборки файл hid.lst уникален.}}

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTe], перейдя в раздел «View Autotests», и выбрав соответствующую сборку и платформу.

=== Перечень тестов ===
Скачанный перечень тестов из [http://quaste.services.openoffice.org/ странице QUASTe] необходимо привести в пригодное для ''run_test'' состояние.
Для этого необходимо открыть его обычным тестовым редактором (например gedit):
* Удалить пробел в каждой строке после ''.bas''. Проще всего это сделать заменой ".bas " на ".bas"
* Удалить служебную информацию, такую как информацию о релизе и категории тестов.

В результате файл должен содержать только список тестов с путями к ним.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен {{OOo}} и удалён [[RU/kb/70000005|профиль {{OOo}}]] (в этом случае каталог Профиля будет иметь то же имя, что и каталог установки {{OOo}}).
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом. Затем запускаем
{{Documentation/Linux|'''run_tests.sh'''}}
{{Documentation/Windows|'''run_tests.vbs''' для Windows}}

Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например:
{{Documentation/Linux|'''''./run_tests.sh < /home/user/DEV300_m75/tests.txt'''''}}
{{Documentation/Windows|'''''cscript run_tests.vbs < C:\DEV300_m75/tests.txt''''' для Windows}}

* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''
В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org и наборы автоматических тестов.



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в <del>CVS/SVN</del> [http://download.services.openoffice.org/files/extended/ http://download.services.openoffice.org/files/extended/], но уже содержит внутри файл hid.lst .

|-
| <nowiki>http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&workspace=</nowiki>DEV300&milestone=m77&download=2
| Файл hid.lst для помещения в папку testautomation/global/hid

|}

{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{QaBottom}}

RU/qa/automatic testing

2010-05-22T23:45:17Z

Aeroshin: Updated info about source code repository.

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из [http://hg.services.openoffice.org/ репозитария с исходным кодом Mercurial].

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320m17''' или '''DEV300m78'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe] (ссылка на загрузку в самом низу страницы).
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения:

{{Documentation/Linux|'''testtool.bin'''}}
или
{{Documentation/Windows|'''testtool.exe'''}}

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
:''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - '''Директория журналирования''' - каталог для результатов тестирования
:''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* '''Базовая директория''' - каталог с набором автоматических тестов
:''/home/user/DEV300_m75/testautomation''

{{Documentation/Linux|'''Для *nix платформ необходимо вручную указать имя машины.'''

* Открываем файл настроек текстовым редактором, обычно расположен ${HOME}/.testtoolrc,
* Добавляем в конец следующие строки:
[Others]
<nowiki>PCname=<имя машины></nowiki>}}

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл
{{Documentation/Linux|'''run_tests.sh''' применяется для UNIX платформ,}}
{{Documentation/Windows|'''run_tests.vbs''' используется для Windows.}}

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге 
''./testautomation/global/hid/'' 
После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

{{Documentation/Note|ВАЖНО!: Для каждой сборки файл hid.lst уникален.}}

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTE], перейдя в раздел «View Autotests», и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен {{OOo}} и удалён [[RU/kb/70000005|профиль {{OOo}}]] (в этом случае каталог Профиля будет иметь то же имя, что и каталог установки {{OOo}}).
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом. Затем запускаем
{{Documentation/Linux|'''run_tests.sh'''}}
{{Documentation/Windows|'''run_tests.vbs''' для Windows}}

Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например:
{{Documentation/Linux|'''''./run_tests.sh < /home/user/DEV300_m75/tests.txt'''''}}
{{Documentation/Windows|'''''cscript run_tests.vbs < C:\DEV300_m75/tests.txt''''' для Windows}}

* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''
В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org и наборы автоматических тестов.



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в <del>CVS/SVN</del> [http://download.services.openoffice.org/files/extended/ http://download.services.openoffice.org/files/extended/], но уже содержит внутри файл hid.lst .

|-
| <nowiki>http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&workspace=</nowiki>DEV300&milestone=m77&download=2
| Файл hid.lst для помещения в папку testautomation/global/hid

|}

{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{QaBottom}}

File:Ru base dbfilename macros.png

2010-05-22T23:08:14Z

Aeroshin:

Узнать название файла БД из макроса

User:Aeroshin

2010-05-22T22:57:18Z

Aeroshin:

{| style="border-spacing:0;"
| style="border:none;padding:0.097cm;"| Артём Викторович Ерошин, компания Инфра-Ресурс [http://www.i-rs.ru/ www.i-rs.ru], Москва, Россия
| style="border-top:none;border-bottom:none;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| Artem V. Eroshin, the company Infra-Resource [http://www.i-rs.ru/ www.i-rs.ru], Moscow, Russia.

|-
| style="border:none;padding:0.097cm;"| mailto: [mailto:aeroshin@openoffice.org aeroshin@openoffice.org]
| style="border-top:none;border-bottom:none;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| mailto: [mailto:aeroshin@openoffice.org aeroshin@openoffice.org]

|-
| style="border:none;padding:0.097cm;"|

*Инженер контроля качества по платформам Oracle Solaris (x86 / SPARC)

*Инженер TCM по платформам Oracle Solaris (x86 / SPARC)

*Редактор Ru.OpenOffice.Org
| style="border-top:none;border-bottom:none;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"|

*QA Engeneer at Oracle Solaris platform (x86 / SPARC)

*TCM Engeneer at Oracle Solaris platform (x86 / SPARC)

*Content developer of Ru.OpenOffice.Org

|-
|colspan="2" | [[File:User-Aeroshin.jpg|200px|thumb|left|]]

|}

User:Aeroshin

2010-05-22T22:54:37Z

Aeroshin: About user Aeroshin

{| style="border-spacing:0;"
| style="border:none;padding:0.097cm;"| Артём Викторович Ерошин, компания Инфра-Ресурс [http://www.i-rs.ru/ www.i-rs.ru], Москва, Россия
| style="border-top:none;border-bottom:none;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| Artem V. Eroshin, the company Infra-Resource [http://www.i-rs.ru/ www.i-rs.ru], Moscow, Russia.

|-
| style="border:none;padding:0.097cm;"| mailto: [mailto:aeroshin@openoffice.org aeroshin@openoffice.org]
| style="border-top:none;border-bottom:none;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"| mailto: [mailto:aeroshin@openoffice.org aeroshin@openoffice.org]

|-
| style="border:none;padding:0.097cm;"|

*Инженер контроля качества по платформам Oracle Solaris (x86 / SPARC)

*Инженер TCM по платформам Oracle Solaris (x86 / SPARC)

*Редактор Ru.Openoffice.Org
| style="border-top:none;border-bottom:none;border-left:0.002cm solid #000000;border-right:none;padding:0.097cm;"|

*QA Engeneer at Oracle Solaris platform (x86 / SPARC)

*TCM Engeneer at Oracle Solaris platform (x86 / SPARC)

*Content developer of Ru.Openoffice.Org

|-
|colspan="2" | [[File:User-Aeroshin.jpg|200px|thumb|left|]]

|}

File:User-Aeroshin.jpg

2010-05-22T22:42:07Z

Aeroshin: User Aeroshin photo.

User Aeroshin photo.

User:Aeroshin

2010-05-22T18:40:09Z

Aeroshin:

Under construction. Coming soon.

RU/kb/50000004

2010-05-22T18:33:34Z

Aeroshin: Основной текст

{{DISPLAYTITLE:База Знаний: Base. Определение пути к файлу базы данных из макроса}}
[[RU/kb/base automation|База Знаний: Base. Автоматизация обработки данных]]
__NOTOC__

'''Задача:''' Определить полное имя и путь к файлу базы данных из макроса.

'''Решение:''' Воспользуетесь xray - у объекта типа ''com.sun.star.comp.forms.ODatabaseForm'' существует свойство URL, которое возвращает полный URL.

Дескриптор текущего документа Base можно получить через ''CurrentComponent''.

[[File:Ru base dbfilename macros.png]]

[[RU/kb/index/50|Индекс: Base]]

{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{KbBaseBottom}}

File:Ru base dbfilename macros.png

2010-05-22T18:20:22Z

Aeroshin: Узнать название файла БД из миакроса

Узнать название файла БД из миакроса

User:Aeroshin

2010-04-26T15:25:13Z

Aeroshin: Created page with 'd'

RU/rules/wiki editing policy

2010-04-23T08:50:29Z

Aeroshin: /* Graphical Content - russian translation*/

{{RU/documentation/beingedited|[[User:Sancho|Санчо]] 16:55, 4 April 2010 (UTC)}}
{{RU/documentation/helpneeded|Перевод на русский язык.}}
{{Documentation/Banner}}
{{RU/documentation/draftpage}}
{{DISPLAYTITLE:Политика Wiki-редактирования}}
[[fr:FR/Documentation/Dashboard/Wiki_Editing_Policy]]
[[en:Documentation/Dashboard/Wiki_Editing_Policy]]

{{Documentation/Caution|Перед началом редактирования следует ознакомиться с [[RU/rules_and_information_policy|Положением и информационной политикой]] ресурса.}}

Эта статья поможет вам эффективно создавать разделы wiki-документации.

Мы настоятельно рекомендуем Вам, объявлять о создании новых страниц или производстве значительных изменений в список рассылки [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org].

= Набор правил. Независимый проект =
{{Documentation/Note|В начале смотрите главный набор правил [[OOo_Wiki_Contribution_Rules]]}}

=Перед началом редактирования=

Прежде чем вы сможете редактировать, вам нужно зарегистрироваться. Это не сложно.
# Щёлкните по '''Log in / create account''' в правом верхнем углу экрана и введите необходимую информацию. Мы рекомендуем использовать то же имя пользователя, что и на веб-сайте OpenOffice.org.
# Затем вам надо будет подтвердить ваш адрес электропочты.

Для входа в систему используйте точку входа вверху страницы, введите ваш логин и пароль, щёлкнув по кнопке '''Log in'''.

На следующем шаге расскажите Сообществу о себе. Это безвредно и создаёт комфорт для работы в Wiki.
#Когда вы вошли в систему, имя пользователя отображается вверху страницы красным цветом, до тех пор, пока вы не создадите свою страницу. Эта страница является вашим профилем. Щёлкните по своему имени, чтобы создать его.
#На вашей странице, добавьте несколько разделов, как указано ниже, в ваш профиль OpenOffice Wiki;
#* Несколько слов о себе;
#* OpenOffice и вы;
#* Ваш вклад;
#* Направления развития;
#* Какие планы на будущее?;
#* Ссылки (по желанию);
#* Контакты.

Это небольшой шаблон для создания профиля.

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

=Страницы обсуждений=

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

Все важные замечания должны быть объявлены в списке рассылки [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org], дабы гарантировать, что их заметят.

Чтобы добавить комментарий к странице:
# Щёлкните по вкладке '''Обсуждение''' вверху страницы.
#* Если вы начинаете в обсуждении новую тему, щёлкните по знаку '''[+]''' справа от вкладки '''Править''' вверху страницы, заполните тему и запишите свой комментарий в текстовом поле.
#* Если вы хотите добавить комментарий к существующей дискуссии, то создайте отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием), для чего вставьте одно или несколько двоеточий (<code>''':'''</code>) в начале каждого абзаца вашего ответа. Одно двоеточие эквивалентно одному табулятору.
# Подпишите ваше сообщение. Для этого вставьте четыре тильды подряд (<code><nowiki>~~~~</nowiki></code>). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( http://wiki.services.openoffice.org/w/skins/common/images/button_sig.png ) на тулбаре.
# По окончании в поле '''"Описание изменений"''' введите краткое описание сделанных вами изменений и щёлкните по кнопке '''Записать страницу'''.

Более подробная информация о создании обсуждений приведена в статье [http://www.mediawiki.org/wiki/Help:Talk_pages Mediawiki help about talk pages].

=Структура раздела [[Documentation|Документация [en]]] в Wiki=

Раздел '''"Документация"''' это только часть большой Wiki OpenOffice.org. Проект '''doc.oo.o''' пытается представить информацию в этом разделе так, чтобы она была легко доступна и хорошо структурирована для упрощения навигации как пользователей, так и участников

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

Текущая структура выглядит следующим образом:

wiki.services.openoffice.org/wiki/Documentation
|
+---Dashboard
+---Administration Guide
+---FAQ
+---How Tos
+---OOoAuthors User Manual
+---OOo3 User Guides
+---Tutorials
+---Samples, Templates and Clipart
+---Setup Guide
+---BASIC Guide
+---Building Guide
+---DevGuide
+---Reference

{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
|-
!Subpage!!Description
|-
|[[Documentation/Dashboard]]
|Раздел высокого уровня, отслеживающий подпроекты и создаваемое ими содержание.
|-
|[[Documentation/Administration Guide]]
|Руководство по установке и администрированию OpenOffice.org в сети.
|-
|[[Documentation/FAQ]]
|Сборник часто задаваемых вопросов.
|-
|[[Documentation/How Tos]]
|Сборник ссылок на статьи "Как сделать".
|-
|[[Documentation/OOoAuthors User Manual]]
|Сборник документации и руководств пользователя по OpenOffice.org 2.x с ресурса OOoAuthors
|-
|[[Documentation/OOo3 User Guides]]
|Сборник документации и руководств пользователя по OpenOffice.org 3.x с ресурса OOoAuthors
|-
|[[Documentation/Tutorials]]
|Сборники обучающих материалов.
|-
|[[Documentation/Samples, Templates and Clipart]]
|Страница подпроекта шаблонов для бизнеса и личного использования (черновик)
|-
|[[Documentation/Setup Guide]]
|Страница подрпоекта по процессу установки OpenOffice.org (в разработке)
|-
|[[Documentation/BASIC Guide]]
|Введение в программирование на OpenOffice.org BASIC
|-
|[[Documentation/Building Guide]]
|Руководство по разработке пользовательских приложений {{OOo}} из исходных текстов.
|-
|[[Documentation/DevGuide]]
|Руководство по программированию {{OOo}}, использоую технологию UNO (Universal Network Objects).
|-
|[[Documentation/Reference]]
|Сборник справочных материалов. Ссылки на эту страницу ('''Reference Lists''')отображаются на главной странице проекта документации.
|}

=Создание новых страниц=

{{Documentation/Caution | Перед созданием страницы убедитесь, что по данной теме уже не создана страница.}}

* Если новая страница является подстраницей у существующей страницы, просто перейдите к существующей странице и создайте ссылку на новую страницу. После сохранения страницы, щёлкните по созданной ссылке и начните писать вашу новую страницу.
* Если вам необходимо создать совершенно новую самостоятельную страницу, вы можете использовать wiki-URL для создания новой страницы.Для этого в браузере в строке URL введите что-то вроде этого: 
<tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki>базовая_страница_языка/'''''имя_новой_страницы'''''</tt>
:Когда вы создаёте страницу таким образом, вы должны соблюдать существующее дерево wiki-страниц. То есть, если страница относится к какому-либо разделу, то в своём имени она должна содержать имя этого раздела. Например, если создаётся страница в проекте '''"qa"''' (контроль качества) в русской языковой зоне, в браузере в строке URL введите: 
<tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki>RU/'''''qa'''''/'''''имя_новой_страницы'''''</tt>
* Рекомендуемый метод заключается в предварительном поиске нужной информации (поле '''Поиск''' на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке "Создать страницу" на странице результатов поиска.

{{Documentation/Note | Создание страниц напрямую через URL допустимо только если затем будут добавлены ссылки на эту страницу с других страниц. В противном случае эта страница окажется "потерянной" в wiki.}}

{{Documentation/Tip|В [[RU|русской языковой зоне]] существуют дополнительные [[RU/instructions_for_writing_articles|правила написания статей]], обязательные к исполнению.}}

Дополнительная информация по созданию новых статей приведена в [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Документации Mediawiki по созданию новых статей [en]].

=Использование категорий=

Категории, в которые включена страница, как правило, перечислены в нижнем колонтитуле страницы. Щёлкните по категории и вы перейдёте к просмотру страницы заголовков страниц, которые отнесены к данной категории. Таким образом, категории являются тегом (меткой) для страниц, с помощью которого вы даёте возможность просмотреть тематически связанные страницы. В одну категорию может быть собрано большое количество страниц.

Для добавления страницы в категорию, добавьте ссылку <tt><nowiki>[[Category:''Имя_Категории'']]</nowiki></tt> в конце страницы.

Категория уже должна существовать. В противном случае будет создана новая категория, оторванная от общей структуры категорий wiki.

{{Documentation/Caution|Не создавайте дубликаты категорий по одной теме. Имена категорий должны быть уникальными. В противном случае станет весьма затруднительно использовать систему категорий для поиска информации в wiki.}}

Дополнительная информация по категориям находится в [http://www.mediawiki.org/wiki/Help:Categories документации MediaWiki].

Простой пример того, как использовать категории в книгах Wiki:
# Создайте категорию с именем текущего раздела.
# Добавьте новую метку категории для всех страниц этой главы.
# Добавить теги категория для книги на вновь созданной странице категории.

Читатель может просматривать книгу категории. Книга категории включает все части книги. Если читатель щёлкнет по части категории, он увидит все страницы части в алфавитном порядке.

Не добавляйте категорию и её подкатегории на одну wiki-страницу. Дополнительная информация по категориям и подкатегориям в [http://meta.wikimedia.org/wiki/Help:Category#Category_considerations документации MediaWiki].


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

=Шаблоны=

Обратитесь к документации на [http://www.mediawiki.org/wiki/Help:Templates mediawiki]

==Adding a new Documentation Template==
<section begin=addingtemplate />
* Если вы создаёте новый шаблон для использовании, допустим, в разделе wiki Документация, назовите его как дочернюю страницу '''Документация'''.
** некорректно: <tt>новый_шаблон</tt>
** корректно: <tt>Документация/новый_шаблон</tt>

В имени шаблона так же должна присутствовать ''базовая страница языка'', как об этом говорилось выше.

Полностью имя шаблона выглядит так:
<tt>Template:RU/Документация/новый_шаблон</tt>

* Для того, чтобы все шаблоны собрать в одну категорию, добавьте к шаблону собственную категорию, которая, при этом, не будет влиять на категоризацию страницы, на которой будет применён шаблон. Данная категория помещается между тегами <code><noinclude></code>. Подробнее об этом изложено в документации: [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template].

* Созданный шаблон добавьте в список шаблонов, приведённый ниже.
<section end=addingtemplate />
{{Spacer|30}}

== List of Existing Documentation Templates ==

<section begin="doctemplates" /> This is a list of Documentation templates and their usage

{| cellspacing="4" cellpadding="3" border="1" style="border-collapse: collapse;"
|- valign="top"
! Имя шаблона
! Где использовать
! Пример использования
|- valign="top"
| [[Template:Documentation/Banner]]
| Puts the Documentation Project "Banner" at the top right of the page
{{RU/code|50|<nowiki>{{Documentation/Banner}}</nowiki>}}
| [[Image:Docbanner.png]]
|- valign="top"
| [[Template:Documentation/OOo]]
| Displays an OpenOffice.org logo
{{RU/code|50|<nowiki>{{Documentation/OOo}}</nowiki>}}

| {{Documentation/OOo}}
|- valign="top"
| [[Template:Documentation/PDF]]
|
{{RU/code|50|<nowiki>{{Documentation/PDF}}</nowiki>}}
| {{Documentation/PDF}}
|- valign="top"
| [[Template:Documentation/PRODUCTNAME]]
| Переменная для вывода названия продукта '''OpenOffice.org'''.
{{RU/code|50|<nowiki>{{Documentation/PRODUCTNAME}}</nowiki>}}

| {{Documentation/PRODUCTNAME}}
|- valign="top"
| [[Template:Documentation/hbar]]
| Used to draw horizontal bars for simplistic bar charts
{{RU/code|50|<nowiki>{{Documentation/hbar|width=100|bg=#3333FF}}</nowiki> <nowiki>{{Documentation/hbar|width=57|bg=#33FF33}}</nowiki> <nowiki>{{Documentation/hbar|width=112|bg=#FF3333}}</nowiki>}}

|
{{Documentation/hbar|width=100|bg=#3333FF}} {{Documentation/hbar|width=57|bg=#33FF33}} {{Documentation/hbar|width=112|bg=#FF3333}}

|- valign="top"
| [[Template:RU/documentation/beingedited]]
| Устанавливайте данный знак на странице, которую в настоящее время редактируете, чтобы избежать конфликта изменений.
Используйте этот шаблон при выполнении больших изменений в статье, создание которых растягиваются более чем на один сеанс редактирования. Не забудьте добавить имя и дату "замок", добавив <tt><code><nowiki>~~~~</nowiki></code></tt> в качестве параметра шаблона:
{{RU/code|50|<nowiki>{{RU/documentation/beingedited|~~~~}}</nowiki>}}

| {{RU/documentation/beingedited|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)}}
|- valign="top"
| [[Template:RU/documentation/needsrework]]
|
{{RU/code|50|<nowiki>{{RU/documentation/needsrework}}</nowiki>}}
| {{RU/documentation/needsrework}}
|- valign="top"
| [[Template:RU/documentation/helpneeded]]
|
{{RU/code|50|<nowiki>{{RU/documentation/helpneeded|Проверка орфографии}}</nowiki>}}
| {{RU/documentation/helpneeded|Проверка орфографии}}
|- valign="top"
| [[Template:RU/documentation/checkedaccuracy]]
| Отметка для статей, которые были проверены на точность.
Не забудьте добавить своё имя и дату проведения проверки <tt><code><nowiki>~~~~</nowiki></code></tt> в качестве параметра:
{{RU/code|50|<nowiki>{{Documentation/CheckedAccuracy|~~~~}}</nowiki>}}

| {{RU/documentation/checkedaccuracy|Иванов 08:16, 22 января 2009}}
|- valign="top"
| [[Template:RU/documentation/outdated]]
| Указывает, что статья устарела.
{{RU/code|50|<nowiki>{{RU/documentation/outdated}}</nowiki>}}

| {{RU/documentation/outdated}}
|- valign="top"
| [[Template:RU/documentation/draftpage]]
| Метка для страниц, которые находятся в процессе создания (стадия Черновика).
{{RU/code|50|<nowiki>{{RU/documentation/draftpage}}</nowiki>}}

| {{RU/documentation/draftpage}}

|- valign="top"
| [[Template:RU/documentation/imported]]
|
{{RU/code|50|<nowiki>{{RU/documentation/imported|Имя автора|Имя переводчика}}</nowiki>}}
| {{RU/documentation/imported|Имя автора|Имя переводчика}}
|- valign="top"
| [[Template:Documentation/Windows]]
| Отображение логотипа Windows для ввода Windows-зависимого конкрета.
{{RU/code|50|<nowiki>{{Documentation/Windows|Windows-зависимый контент}}</nowiki>}}

| {{Documentation/Windows| Windows-зависимый контент}}
|- valign="top"
| [[Template:Documentation/Linux]]
| Отображение логотипа Linux для ввода Linux-зависимого конкрета.
{{RU/code|50|<nowiki>{{Documentation/Linux|Linux-зависимый контент}}</nowiki>}}

| {{Documentation/Linux| Linux-зависимый контент}}
|- valign="top"
| [[Template:Documentation/OSX]]
| Отображение логотипа Apple/OSX для ввода OSX-зависимого конкрета.
{{RU/code|50|<nowiki>{{Documentation/OSX | Mac related content}}</nowiki>}}

| {{Documentation/OSX | Mac-зависимый контент}}
|- valign="top"
| [[Template:Bug]]
| Ссылки на вопрос (баг) в Issuezilla.
{{RU/code|50|<nowiki>{{Bug|123456}}</nowiki>}}

| {{Bug|123456}}
|- valign="top"
| [[Template:Documentation/Note]]
| Применяется для примечаний, для концентрации внимания. Например, объяснений и комментариев.
{{RU/code|50|<nowiki>{{Documentation/Note|Это примечание}}</nowiki>}}

| {{Documentation/Note|Это примечание}}
|- valign="top"
| [[Template:Documentation/Tip]]
| Применяется для выделения не критичной информации - например, для привлечения внимания к клавиатурным комбинациям.
{{RU/code|50|<nowiki>{{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}}</nowiki>}}

| {{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}}
|- valign="top"
| [[Template:Documentation/Caution]]
| Примется для предупреждений, для потенциально опасной информации, например, влекущую потерю данных.
{{RU/code|50|<nowiki>{{Documentation/Caution|Стирание файла может его уничтожить.}}</nowiki>}}

| {{Documentation/Caution|Стирание файла может его уничтожить.}}
|- valign="top"
| [[Template:RU/documentation/seealso]] and [[Template:RU/documentation/devguide/seealso]]
|
{{RU/code|50|<nowiki>{{RU/documentation/seealso|
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
}}</nowiki>}}
*'''DevGuide''' / '''Смотри также''' используются в Руководстве для разработчиков и должны быть исключены из создаваемых PDF и ODT книг.

| {{RU/documentation/seealso|
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
}}
|- valign="top"
| [[Template:RU/fromforum]]
|
{{RU/code|50|<nowiki>{{RU/fromforum}}</nowiki>}}
| {{RU/fromforum}}
|- valign="top"
| [[Template:Documentation/Abstract]]
| Takes a short abstract of the chapter content of guides. Add to the top of guides.
{{RU/code|50|<nowiki>{{Documentation/Abstract|Abstract Text}}</nowiki>}}

| See, for example, [[Documentation/Administration Guide/Customizing|this Administration Guide Chapter]]
|- valign="top"
| Template:Documentation/*TOC
| Several tables of content based on [[Template:Documentation/MasterTOC]] used in guides.
| See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
|- valign="top"
| [[Template:Documentation/MasterTOC]]
| This is the master template that is used to create tables of content. For usage click the template name.
|- valign="top"
| [[Template:Documentation/OOoVersion]]
| Этот шаблон используется для вставки на странице окна с номером версии OpenOffice.org.
{{RU/code|50|<nowiki>{{RU/documentation/oooversion|3.3.x}}</nowiki>}}
| {{RU/documentation/oooversion|3.3.x}}
|- valign="top"
| [[Template:RU/documentation/sign]]
| Этот шаблон используется для вставки в статью подписи с именем автора. Первый параметр - логин автора. Второй параметр - имя, которое будет отображено в подписи.
{{RU/code|50|<nowiki>{{RU/documentation/sign|Sancho|А. Е. Харламенков}}</nowiki>}}
| {{RU/documentation/sign|Sancho|А. Е. Харламенков}}
|- valign="top"
| [[Template:RU/documentation/signyear]]
| Этот шаблон используется для вставки в статью подписи с именем автора и датой создания статьи. Первый параметр - логин автора. Второй параметр - имя, которое будет отображено в подписи. Третий параметр - дата, выводимая в подписи.
{{RU/code|50|<nowiki>{{RU/documentation/signyear|Sancho|А. Е. Харламенков|2009}}</nowiki>}}
| {{RU/documentation/signyear|Sancho|А. Е. Харламенков|2009}}
|}

<section end="doctemplates" />

=Изображения и графика=

Вот основные правила для картинок

* Заголовок картинки должен быть уникальным и информативным. Имя файла так же должно иметь смысл, например '''scr_writer_conf_slovar.png''' отлично подойдёт для скриншота('''scr''') окна настройки('''conf''') словаря('''slovar''') в OOo Writer('''writer''').
* Загружать картинки лучше в их оригинальном разрешении, если это возможно. Wiki автоматически создаёт уменьшенные картинки, которые в последствии можно вставлять в статьи
* Рекомендуется отредактировать картинку так, чтобы сделать основную её часть более заметной. Например: подчеркнуть красной линией нужную команду в меню.
* Всегда помните о том, что статью с вашим изображением могут перевести на другой язык. Избегайте подписей и сносок на самой картинке, это упростит процедуру перевода.
* Форматы: JPG для фотографий, SVG для значков, логотипов и т.п., PNG - для снимков экрана. Запрещяется использовать BMP. (Paint давно поддерживает другие форматы)

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

Загруженные картинки размещаются на странице с помощью следующего тега:
<nowiki>[[Image:<имя>|<предпр.>|<положение>|<размер в px>|<надпись>]]</nowiki>

* Имя: имя файла загруженной картинки.
* Предпр.: thumb - создать уменьшенню копию и поместить в обрамление; none - вставить как есть.
* Положение: положение картинки на странице, left - слева с обтеканием; right - справа с обтеканием; none - картинка расположится слева, без обтекания.
* Размер: максимальная ширина картинки в px. Если изображение больше этого значения, то обо будет смасштабировано, если меньше, то останется как есть.

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

<nowiki>Например:[[Image:'''LoadSaveOptions.png'''|thumb|left|250px|Окно настройки OOo]]</nowiki>

[[Image:LoadSaveOptions.png|thumb|left|250px|Окно настройки OOo]]

* How to handle image and table numbering?

=Linking=

Although the editing window offers assistence in writing internal and external links look at the [http://www.mediawiki.org/wiki/Help:Links MediaWiki help page about links] for a better understanding of how links are working in wikis.

There is another MediaWiki help page if you need some [http://meta.wikimedia.org/wiki/Help:Wikitext_examples#Links examples].

When creating link text consider the guidelines for [[Documentation/Dashboard/Help_Style_Guide#Using_Links | using links]] in our style guide.

=Основные работы по редактированию=

Редактирование возможно только после входа под своим именем. Вы можете редактировать сразу всю страницу, нажав на вкладке '''править''' на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, нажав на ссылку '''[править]''' справа от заголовка раздела. При редактировании, просьба соблюдать принятые [[Documentation/Dashboard/Help_Style_Guide|стили оформления [EN]]] в целях обеспечения единства стилей всех статей. Перед сохранением изменений, нажмите кнопку '''"Предварительный просмотр"'''.

== Fixing inappropriate, inaccurate, or outdated content ==

Contents that are not up to date are usually marked by one of the following labels:

{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
|- valign=top
| {{Documentation/Outdated}}
| This label means that an article is outdated as a whole and needs to be revised completely.
|- valign=top
| {{Documentation/HelpNeeded|works for OOo 2, needs to be confirmed for OOo 3}}
| If an article is partly outdated or inaccurate you may find this label asking for specific help.
|- valign=top
| {{Documentation/NeedsRework}}
| You can find a collection of pages with this label if you click on [[:Category:Documentation/NeedsRework|Pages that Need Help! ]] on the Wiki main page.
|}

When you have selected a page to work on

#test whether the described procedures are still valid for the current version of OpenOffice.org.
#log in and make the necessary corrections.

This works best when you open two tabs in the browser, one for reading the procedures and another for editing.

When you have finished, remove the above label(s), mark the page with the label "Checked for technical accuracy" (as described in the [[Documentation/Dashboard/Wiki Editing Policy#List_of_Existing_Documentation_Templates|Templates]] section above), and click '''Save page'''.

==Fixing minor errors and typos==

If you detect minor errors like typos, just log in and edit the article. Before clicking on the '''Save page''' button you might check the '''This is a minor edit''' box above.

==Fixing graphics and screenshots==

To edit a graphic in the wiki, right-click the graphic and choose '''Save image as'''. When you have edited the graphic on your computer, go back to the wiki page, click the graphic, and in the image description page choose '''Upload a new version of this file'''.

If you have created a new version of a screenshot, directly click the corresponding screenshot in the wiki and then '''Upload a new version of this file''' in the image description page.

==Fixing Style and Language==

Articles that need improvement in style and language might be recognized by the following labels:
{{Documentation/HelpNeeded|Check the spelling}}
{{Documentation/NeedsRework}}
You can find a collection of articles with the latter label if you click on [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] on the Wiki main page.

To improve such an article, just log in, click on the edit tab and make the necessary corrections. Then remove the label(s) and click on '''Save page'''.

==Linking to localized pages==

* Link the various languages to each other using the Interwiki links syntax <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. For example, <tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt> adds a link to the Chinese translation of the first page of the Developer's Guide. This link shows in the left column, under the heading "In other languages". This may be more practical to do with Wiki Templates as more languages are added.
* In the Developer's guide we use a template to link translated pages. The Wiki Syntax is: <tt><nowiki>
{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt> where Page_Title is the current Wiki page name. For example, <tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org
Developers Guide}}</nowiki></tt> will add the localized page links for the first page in the Developer's Guide. If you want to see a link to your language at the Developer's Guide wiki pages simply add your language to the template [[Template:Documentation/DevGuideLanguages]]. For example, for Dutch you would have to add <tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>. Make sure the template is referenced correctly in each of the translated pages.

==Validating Content==

==Fixing Spam / Deleting Pages==

If you detect spam you can send a mail to [mailto:dev@website.openoffice.org dev@website.openoffice.org].

There is also a [[Special:Listusers/sysop|list with Wiki Sysops]] (people who can delete pages). If you want to have pages deleted, you can either ask someone from that list, or better, add the Wiki Syntax <tt><nowiki>{{delete}}</nowiki></tt> anywhere on the page you want to be deleted. This will add the page to the "Candidates for speedy deletion" category, and the page will be deleted by someone with Sysop privileges, or by WikiBot maintenance.

=Working on FAQs=
Every question together with its answer is displayed on one single wiki page.

If you want to insert a new FAQ entry, that is, a pair of a question together with the corresponding answer:
<ol>
<li> Select a FAQ section on the main page of the Documentation Wiki. In Writer and Calc you have to select another subpage until you reach a final FAQ section.</li>
<li> Scroll down to the Insert New FAQ listbox.</li>
<li> Replace the text in the listbox after the last slash '/' with your question.</li>
<li> Click '''Add New FAQ''' A new wiki page will be created and preloaded with a template for a Q/A pair: </li>

<source lang="text">
{{{DISPLAYTITLE: (INSERT FAQ TITLE)}}

<section begin=question/>
<INSERT QUESTION>
<section end=question/>

<section begin=answer/>
<INSERT ANSWER>
<section end=answer/>

[[Category:Documentation/FAQ/<INSERT FAQ SECTION>]]

</source>

<li> Replace <tt>(INSERT FAQ TITLE)</tt> with the title of the FAQ to be displayed on the page. This may be a short version of the question or the question itself.</li>
<li> Replace <tt><INSERT QUESTION></tt> with the actual question.</li>
<li> Replace <tt><INSERT ANSWER></tt> with the actual answer.</li>
<li> Replace <tt><INSERT FAQ SECTION></tt> with the current FAQ section name. This category assignment determines where this wiki page will appear. Please use the following section names:</li>

{|class="prettytable sortable"
|-
!FAQ section !!section name in category
|-valign=top
|General||General
|-valign=top
|Installation||Installation
|-valign=top
|Word Processing||Writer
|-valign=top
|Automatic Functions||Writer/AutomaticFunctions
|-valign=top
|Document Management||Writer/DocumentManagement
|-valign=top
|Formatting Pages and Docs||Writer/FormattingPagesAndDocuments
|-valign=top
|Formatting Text||Writer/FormattingText
|-valign=top
|Graphics, Frames & Objects||Writer/GraphicsFramesObjects
|-valign=top
|Indexes, Tables of Contents||Writer/IndexToc
|-valign=top
|Printing and Mail Merge||Writer/Printing
|-valign=top
|Spreadsheets||Calc
|-valign=top
|Drawings||Draw
|-valign=top
|Presentations||Impress
|-valign=top
|Formula Editor||Formula
|-valign=top
|Database||Databases
|-valign=top
|Macros||Macros
|}
<li>Click '''Save Page'''.</li>
</ol>

=Working on How Tos=
If you want to create a new How To
# Go to the [[Documentation/How_Tos | How Tos section]] and open the edit window.
# Identify the adequate subsection and enter the title of your How To as a link.
# Click '''Save Page''' to make the link visible.
# Click the link to your How To and start writing by using the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]]. If you are not sure about how to implement the style guide, have a look at the Writer How To [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].

{{Documentation/Note|Always put the licence link at the end of your article: Simply insert <tt><nowiki>{{PDL1}}</nowiki></tt>. }}

You can also create How Tos by writing a new page like <tt>Documentation/How Tos/''Page Name''</tt> with one or more specific categories. The newly created How To page will then be assigned to the corresponding How To sections. The available categories for that are the following:
* <tt><nowiki>[[Category:Documentation/How Tos/Installation]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Writer]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Impress]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Calc]]</nowiki></tt>
* <tt><nowiki>[[Category:Documentation/How Tos/Database]]</nowiki></tt>

If you want to revise existing How Tos, watch for the label "This article needs to be checked for accuracy and style."
* Test whether the described procedures are still valid for the current version of OpenOffice.org,
* check whether the rules of the style guide are applied,
* check for grammar and spelling mistakes,
and make the necessary corrections in the edit window.

When you have finished, mark the page with the label "Checked for technical accuracy" as described in the [[Documentation/Dashboard/Wiki_Editing_Policy#List_of_Existing_Documentation_Templates | Templates]] section above, and click '''Save page'''.

Do not forget to notify [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] about your work on the How Tos.

=Working on Guides=
Currently, there are the following guides on the wiki:
* [[Documentation/Administration_Guide|The Administration Guide]]
* [[Documentation/BASIC_Guide|The BASIC Programming Guide]]
* [[Documentation/Building_Guide|The Building Guide (OO.o from source)]]
* [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|The Developer's Guide]]
* [[Documentation/OOoAuthors_User_Manual|The User Guides for OpenOffice.org 2.x]]
* [[Documentation/OOo3_User_Guides|The User Guides for OpenOffice.org 3.x]]

If you want to work on the User Guides for OpenOffice.org please contact the [http://www.oooauthors.org OOoAuthors group].

There is some help available about [[Documentation/DevGuide/Contributing_to_the_Developers_Guide|Contributing to the Developer's Guide]] which may also be useful for the Administration Guide and the BASIC Programming Guide.

=Localizing Content=

{{#lst:Help:Translating|translating}}

----
P. S. Данная статья не является устаревшей. Отнесение к категории [[:Category:RU/older articles]] произошло из-за демонстрации работы шаблона {{RU/code|50|<nowiki>{{Template:RU/documentation/outdated}}</nowiki>}} выше по тексту.

----

{{PDL1}}

[[Category:Help]]
[[Category:How to]]
[[Category:Guidelines]]
[[Category:Localization]]
[[Category:Documentation/Dashboard]]

RU/qa/automatic testing

2010-04-15T13:19:43Z

Aeroshin: /* Настройка VCLTestTool */ PCname

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe] (ссылка на загрузку в самом низу страницы).
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения:

{{Documentation/Linux|'''testtool.bin'''}}
или
{{Documentation/Windows|'''testtool.exe'''}}

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
:''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - '''Директория журналирования''' - каталог для результатов тестирования
:''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* '''Базовая директория''' - каталог с набором автоматических тестов
:''/home/user/DEV300_m75/testautomation''

'''Для *nix платформ необходимо вручную указать имя машины.'''
* Открываем файл настроек текстовым редактором, обычно расположен ${HOME}/.testtoolrc,
* Добавляем в конец следующие строки:

[Others]

PCname=<имя машины>

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл
{{Documentation/Linux|'''run_tests.sh''' применяется для UNIX платформ,}}
{{Documentation/Windows|'''run_tests.vbs''' используется для Windows.}}

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге 
''./testautomation/global/hid/'' 
После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

{{Documentation/Note|ВАЖНО!: Для каждой сборки файл hid.lst уникален.}}

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTE], перейдя в раздел «View Autotests», и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом. Затем запускаем
{{Documentation/Linux|'''run_tests.sh'''}}
{{Documentation/Windows|'''run_tests.vbs''' для Windows}}

Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например:
{{Documentation/Linux|'''''./run_tests.sh < /home/user/DEV300_m75/tests.txt'''''}}
{{Documentation/Windows|'''''cscript run_tests.vbs < C:\DEV300_m75/tests.txt''''' для Windows}}

* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''
В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

----
{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{QaВottom}}

RU/qa/automatic testing

2010-04-05T12:41:03Z

Aeroshin: Removed DocNote

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe]
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения:

{{Documentation/Linux|'''testtool.bin'''}}
или
{{Documentation/Windows|'''testtool.exe'''}}

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
:''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - Каталог для результатов тестирования
:''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* Каталог с набором автоматических тестов
:''/home/user/DEV300_m75/testautomation''

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл
{{Documentation/Linux|'''run_tests.sh''' применяется для UNIX платформ,}}
{{Documentation/Windows|'''run_tests.vbs''' используется для Windows.}}

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге 
''./testautomation/global/hid/'' 
После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

{{Documentation/Note|ВАЖНО!: Для каждой сборки файл hid.lst уникален.}}

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTE], перейдя в раздел «View Autotests», и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом. Затем запускаем
{{Documentation/Linux|'''run_tests.sh'''}}
{{Documentation/Windows|'''run_tests.vbs''' для Windows}}

Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например:
{{Documentation/Linux|'''''./run_test.sh < /home/user/DEV300_m75/tests.txt'''''}}
{{Documentation/Windows|'''''cscript run_test.vbs < C:\DEV300_m75/tests.txt''''' для Windows}}

* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''
В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

----
{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{QaВottom}}

RU/qa/automatic testing

2010-04-03T16:23:42Z

Aeroshin: added DocNote

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
{{Documentation/Note|This is Kb/99999999!}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe]
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения:

{{Documentation/Linux|'''testtool.bin'''}}
или
{{Documentation/Windows|'''testtool.exe'''}}

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
:''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - Каталог для результатов тестирования
:''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* Каталог с набором автоматических тестов
:''/home/user/DEV300_m75/testautomation''

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл
{{Documentation/Linux|'''run_tests.sh''' применяется для UNIX платформ,}}
{{Documentation/Windows|'''run_tests.vbs''' используется для Windows.}}

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге 
''./testautomation/global/hid/'' 
После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

{{Documentation/Note|ВАЖНО!: Для каждой сборки файл hid.lst уникален.}}

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTE], перейдя в раздел «View Autotests», и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом. Затем запускаем
{{Documentation/Linux|'''run_tests.sh'''}}
{{Documentation/Windows|'''run_tests.vbs''' для Windows}}

Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например:
{{Documentation/Linux|'''''./run_test.sh < /home/user/DEV300_m75/tests.txt'''''}}
{{Documentation/Windows|'''''cscript run_test.vbs < C:\DEV300_m75/tests.txt''''' для Windows}}

* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''
В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

----
{{RU/documentation/signyear|Aeroshin|А. В. Ерошин|2010}}

{{QaВottom}}

RU/qa/automatic testing

2010-04-02T15:06:37Z

Aeroshin: fixed link views, few text edits

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCLTestTool ==
VCLTestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

[http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Утилита доступна] для различных платформ.

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ скачать в виде готового пакета], которые достаточно распаковать.

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
[http://download.openoffice.org/next/other.html Скачать] тестовые сборки OpenOffice.org

= Тестирование =
== Подготовка тестовой среды ==
* [http://download.openoffice.org/next/other.html Скачать] и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs'').
* Скачать и распаковать набор тестов Например: '''[http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 OOo_DEV300_m75_testautomation.tar.bz2] '''
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt ''' [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 со страницы QUASTe]
* [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html Скачать] и распаковать '''VCLTestTool'''
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCLTestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения: '''testtool.bin''' или '''testtool.exe''' (для Windows)

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org
''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - Каталог для результатов тестирования
''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* Каталог с набором автоматических тестов
''/home/user/DEV300_m75/testautomation''

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл '''run_tests.sh''' применяется для UNIX платформ, '''run_tests.vbs''' используется для Windows.

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге ''./testautomation/global/hid/''. После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

'''ВАЖНО!: Для каждой сборки файл hid.lst уникален.'''

Скачать '''hid.lst''' и перечень тестов можно на [http://quaste.services.openoffice.org/ странице QUASTE] перейдя в раздел «View Autotests» и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в ''./testautomation/global/hid/'' .
* Составлен перечень тестов из '''DEV300_m75.txt''', если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

* Открываем консоль и переходим в каталог со скриптом '''run_tests.sh''' ( '''run_tests.vbs для Windows''')
Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
* Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.
Например: '''''./run_test.sh < /home/user/DEV300_m75/tests.txt'''''
Для Windows: '''''cscript run_test.vbs < C:\DEV300_m75/tests.txt'''''
* Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста. Например ''./testautomation/writer/required/w_updt.bas''
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на openoffice.org

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт ''./testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''
В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

----
[[User:Aeroshin|А. Ерошин]] 
2010

{{QaВottom}}

RU/qa/automatic testing

2010-04-02T14:46:13Z

Aeroshin: added images

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCL TestTool ==
VCL TestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

Скачать утилиту для различных платформ: [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно скачть в виде готового пакета, которые достаточно распаковать. [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
Тестовые сборки находятся по адресу: [http://download.openoffice.org/next/other.html http://download.openoffice.org/next/other.html]

= Тестирование =
== Подготовка тестовой среды ==
* Скачать и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs''). [http://download.openoffice.org/next/other.html http://download.openoffice.org/next/other.html]
* Скачать и распаковать набор тестов '''OOo_DEV300_m75_testautomation.tar.bz2'' '''''([http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2]
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt '''(ссылки находятся внизу страницы [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11] )
* Скачать и распаковать '''VCLTestTool''' [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCL TestTool ===
[[File:Qa_automatic_testing_img01.png|200px|thumb|right|Окно настройки VCLTestTool]] Исполняемый файл приложения: '''testtool.bin''' или '''testtool.exe''' (для Windows)

После распаковки VCLTestTool необходимо указать несколько параметров:
[[File:Qa_automatic_testing_img02.png|200px|thumb|right|Окно настройки VCLTestTool]]
''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - Каталог для результатов тестирования''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* Каталог с набором автоматических тестов''/home/user/DEV300_m75/ testautomation''

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл '''run_tests.sh''' применяется для UNIX платформ, '''run_tests.vbs''' используется для Windows.

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге ''./testautomation/global/hid/''. После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

'''ВАЖНО!: Для каждой сборки файл hid.lst уникален.'''

Скачать '''hid.lst''' и перечень тестов можно на странице QUASTE [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org/] перейдя в раздел «View Autotests» и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в .''/testautomation/global/hid/.''
* Составлен перечень тестов из '''DEV300_m75.txt''',''' '''если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

# Открываем консоль и переходим в каталог со скриптом '''run_tests.sh''' ( '''run_tests.vbs для Windows) '''Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
# Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.Например: '''''./run_test.sh < /home/user/DEV300_m75/tests.txt'''''Для Windows: '''''cscript run_test.vbs < C:\DEV300_m75/tests.txt'''''
# Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста.Например ./''testautomation/writer/required/''w_updt.bas
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на [http://openoffice.org/ http://openoffice.org].

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт .''/testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''

В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org



|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

----
[[User:Aeroshin|А. Ерошин]] 
2010

{{QaВottom}}

File:Qa automatic testing img02.png

2010-04-02T14:37:56Z

Aeroshin:

File:Qa automatic testing img01.png

2010-04-02T14:35:01Z

Aeroshin:

RU/qa/automatic testing

2010-04-02T14:31:56Z

Aeroshin: nowiki

{{DISPLAYTITLE:Контроль качества: Инструкция "Автоматическое тестирование OpenOffice.org"}}
__TOC__

= Инструменты =
== Утилита автоматического тестирования VCL TestTool ==
VCL TestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

Скачать утилиту для различных платформ: [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно скачть в виде готового пакета, которые достаточно распаковать. [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
Тестовые сборки находятся по адресу: [http://download.openoffice.org/next/other.html http://download.openoffice.org/next/other.html]

= Тестирование =
== Подготовка тестовой среды ==
* Скачать и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs''). [http://download.openoffice.org/next/other.html http://download.openoffice.org/next/other.html]
* Скачать и распаковать набор тестов '''OOo_DEV300_m75_testautomation.tar.bz2'' '''''([http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2]
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt '''(ссылки находятся внизу страницы [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11] )
* Скачать и распаковать '''VCLTestTool''' [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCL TestTool ===
Исполняемый файл приложения: '''testtool.bin''' или '''testtool.exe''' (для Windows)

[[Image:]]После распаковки VCLTestTool необходимо указать несколько параметров:

''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - Каталог для результатов тестирования''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* [[Image:]]Каталог с набором автоматических тестов''/home/user/DEV300_m75/ testautomation''

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл '''run_tests.sh''' применяется для UNIX платформ, '''run_tests.vbs''' используется для Windows.

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге ''./testautomation/global/hid/''. После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

'''ВАЖНО!: Для каждой сборки файл hid.lst уникален.'''

Скачать '''hid.lst''' и перечень тестов можно на странице QUASTE [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org/] перейдя в раздел «View Autotests» и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в .''/testautomation/global/hid/.''
* Составлен перечень тестов из '''DEV300_m75.txt''',''' '''если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

# Открываем консоль и переходим в каталог со скриптом '''run_tests.sh''' ( '''run_tests.vbs для Windows) '''Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
# Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.Например: '''''./run_test.sh < /home/user/DEV300_m75/tests.txt'''''Для Windows: '''''cscript run_test.vbs < C:\DEV300_m75/tests.txt'''''
# Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста.Например ./''testautomation/writer/required/''w_updt.bas
# Запускаем тест по [F5] или из меню «Программа - Запустить»

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на [http://openoffice.org/ http://openoffice.org].

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт .''/testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''

В консоль выводится итоговая таблица.

Можно перенаправить в файл: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org

|-
| [http://community.i-rs.ru/index.php/board,19.0.html http://community.i-rs.ru/index.php/board,19.0.html]
| Раздел на форуме: Контроль качества

|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

----
[[User:Aeroshin|А. Ерошин]] 
2010

{{QaВottom}}

RU/qa/automatic testing

2010-04-02T14:23:53Z

Aeroshin: new wiki page

== '''Автоматическое тестирование OpenOffice.org''' ==

__TOC__

= Инструменты =
== Утилита автоматического тестирования VCL TestTool ==
VCL TestTool — это самостоятельное приложение, которое взаимодействует с OpenOffice.org через протокол TCP/IP.

Скачать утилиту для различных платформ: [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]

== Наборы программ-сценариев автоматических тестов (testautomation) ==
Каждой сборке OpenOffice.org соответствует уникальный набор программ-сценариев для автоматического тестирования. По умолчанию, его можно получить из репозитария с исходным кодом CVS или SVN.

Помимо репозитария, набор тестов можно скачть в виде готового пакета, которые достаточно распаковать. [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]

При скачивании пакета необходимо знать номер сборки OpenOffice.org. Например: '''OOO320_m12''' или '''DEV300_m75'''.

== Тестовые сборки OpenOffice.org ==
Тестовые сборки находятся по адресу: [http://download.openoffice.org/next/other.html http://download.openoffice.org/next/other.html]

= Тестирование =
== Подготовка тестовой среды ==
* Скачать и установить тестируемую сборку (''Full install English (US)'') OpenOffice.org, например '''DEV300_m75''', и русский языковой пакет (''Russian language packs''). [http://download.openoffice.org/next/other.html http://download.openoffice.org/next/other.html]
* Скачать и распаковать набор тестов '''OOo_DEV300_m75_testautomation.tar.bz2'' '''''([http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2 http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/OOo_DEV300_m75_testautomation.tar.bz2]
* Скачать файл '''hid.lst''' и файл-перечень тестов '''DEV300_m75.txt '''(ссылки находятся внизу страницы [http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11 http://quaste.services.openoffice.org/index.php?option=com_quaste&task=tests_overview&Itemid=11] )
* Скачать и распаковать '''VCLTestTool''' [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
* Настроить VCLTestTool и скрипт для пакетного запуска тестов (описано далее).

== Настройка инструментов ==
=== Настройка VCL TestTool ===
Исполняемый файл приложения: '''testtool.bin''' или '''testtool.exe''' (для Windows)

[[Image:]]После распаковки VCLTestTool необходимо указать несколько параметров:

''Меню «Дополнительно — Настройки», далее по вкладкам''

* Вкладка «Обычный» - Директория program текущей установки OpenOffice.org''/opt/ooo-dev3/program/''
* Вкладка «Профиль» - Каталог для результатов тестирования''/home/user/DEV300_m75/work-dev300_m75-linux-x32/''
* [[Image:]]Каталог с набором автоматических тестов''/home/user/DEV300_m75/ testautomation''

=== Настройка скрипта пакетного запуска ===
В каталоге ''./testautomation/tools/run_tests/'' находятся скрипты пакетного запуска тестов. Файл '''run_tests.sh''' применяется для UNIX платформ, '''run_tests.vbs''' используется для Windows.

Перед запуском скрипта требуется указать настройки — отредактировав его.

* Переменная '''sLocation''' указывает на каталог со сценариями тестирования (например: ''/home/user/DEV300_m75/testautomation/'' )
* Переменная '''sTestTool '''должна содержать путь к testtool.bin / testtool.exe (например: ''/home/user/DEV300_m75/VCLTestTool/testtool.bin'' )

=== Hid.lst ===
Файл '''hid.lst '''должен размещаться в каталоге ''./testautomation/global/hid/''. После распаковки набора тестов необходимо проверить его наличие в этом каталоге. Если нет, то скачать, в соответствии с версией сборки OpenOffice.org.

'''ВАЖНО!: Для каждой сборки файл hid.lst уникален.'''

Скачать '''hid.lst''' и перечень тестов можно на странице QUASTE [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org/] перейдя в раздел «View Autotests» и выбрав соответствующую сборку и платформу.

== Проведение автоматических тестов ==
Беглая проверка перед началом тестирования:

* Установлен OpenOffice.org и удалён профиль пользователя.
* Настроено средство тестирования VCLTestTool.
* Распакованы тесты и файл hid.lst находится в .''/testautomation/global/hid/.''
* Составлен перечень тестов из '''DEV300_m75.txt''',''' '''если требуется пакетный запуск тестов.
* Пуст рабочий каталог для результатов '''work-dev300_m75-linux-x32'''.

=== Пакетное тестирование ===
Наиболее простой способ проведения тестов.

# Открываем консоль и переходим в каталог со скриптом '''run_tests.sh''' ( '''run_tests.vbs для Windows) '''Например: ''/home/user/DEV300_m75/testautomation/tools/run_tests/''
# Запускаем скрипт на выполнение с передачей ему на стандартный ввод содержимого файла-списка тестов.Например: '''''<nowiki>./run_test.sh < /home/user/DEV300_m75/tests.txt</nowiki>'''''Для Windows: '''''<nowiki>cscript run_test.vbs < C:\DEV300_m75/tests.txt</nowiki>'''''
# Ждём завершения тестирования. Крайне желательно иногда следить за тем, как проходит тестирование.

=== Запуск единичного теста ===
Иногда требуется запустить конкретный тест.

# Запускаем VCLTestTool
# Открываем файл теста.Например ./''testautomation/writer/required/''w_updt.bas
# <nowiki>Запускаем тест по [F5] или из меню «Программа - Запустить»</nowiki>

== Обработка результатов ==
Результаты тестирования могут быть загружены в QUASTe (Quality Assurance Statuspage), для этого необходимо иметь учётную запись на [http://openoffice.org/ http://openoffice.org].

Помимо загрузки в QUASTe можно получить общую таблицу с результатами. Для этого существует скрипт .''/testautomation/tools/analyze/make_summary.pl''

'''Для запуска требуется Perl.'''

Запускается командой: '''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res'''''

В консоль выводится итоговая таблица.

Можно перенаправить в файл:'''''perl ./make_summary.pl /home/user/DEV300_m75/work-dev300_m75-linux-x32/*.res > /home/user/DEV300_m75/work-dev300_m75-linux-x32/summary.txt'''''

= Ссылки и дополнительная информация =

{| class="prettytable"
| <center>'''Ссылка'''</center>
| <center>'''Описание'''</center>

|-
| [http://qa.openoffice.org/ http://qa.openoffice.org]
| Страница проекта контроля качества

|-
| [http://quaste.services.openoffice.org/ http://quaste.services.openoffice.org]
| QUASTe — Страница состояния контроля качества

|-
| [http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance http://wiki.services.openoffice.org/wiki/Category:Quality_Assurance]

| Страница Wiki Контроль Качества.

|-
| [http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html]
| Страница с бинарными файлами VCLTestTool

|-
| [http://download.openoffice.org/next/ http://download.openoffice.org/next/]
| Тестовые сборки OpenOffice.org

|-
| [http://community.i-rs.ru/index.php/board,19.0.html http://community.i-rs.ru/index.php/board,19.0.html]
| Раздел на форуме: Контроль качества

|-
| [http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/ http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/]
| Наборы автоматических тестов. Тоже самое, что расположено в CVS/SVN.

|}

RU/qa

2010-04-02T14:00:30Z

Aeroshin:

RU/qa

2010-04-02T13:58:42Z

Aeroshin:

[[Category:Контроль качества]]

{{qaВottom}}

RU/qa

2010-04-02T13:54:48Z

Aeroshin: blank

[[Category:Контроль качества]]

Windows

2007-11-22T12:28:35Z

Aeroshin: /* Visual Studio .NET 2003 Professional */

== Welcome to OOo development for Windows ==

This is an initial attempt to fill out information for building on Windows.
If it ends up being complete, this notice can be removed! At the moment you'll have to piece together information from [[#See also|other pages]] with the changes here for doing it on Windows.

Most of this wiki assumes that you'll be using a reasonably current Linux system, as a time saving feature. While real hackers prefer [http://www.gnu.org Free software], if you're forced to build stuff for Windows, this is the place to be.

== Development Tools ==

There have been several different ways of building with more or less success...

The reference page to look at is the misleadingly named page [http://tools.openoffice.org/dev_docs/build_windows_tcsh.html Building under Windows with tcsh]. Despite the name, tcsh is not involved nowadays. If you are going to use the ooo-build method, you should stop reading that page after the Cygwin section. The ooo-build build system will download the rest of the dependencies. One exception is gdiplus.dll which cannot be downloaded automatically as it requires Genuine Windows authentication.

Different compilers that can or can not be used to build are documented below. The official way is Visual C++ .NET 2003.

=== Visual Studio .NET 2003 Professional ===

The C++ compiler included in Visual Studio .NET 2003 is the official one used to build OpenOffice.org. When installing, unless you need them otherwise, there is no need to install the Visual Basic, C#, J#, or .NET 1.1 SDK components.

=== Visual Studio .NET 2003 Standard (approx $100 price) ===

NB: These fixes have been rolled into more recent milestones, so you should now be able to happily build using standard. This is a tag to remove these notes and the page at some future point. --[[User:KaiB|KaiB]] 13:14, 1 June 2006 (CEST)

You can use the Standard version of Visual Studio to build OpenOffice but there are certain workarounds needed. The problem is that OO.o enables /O flags in Professional that conveniently cripples the compiler enough to hide some ugly hacks and bugs that have crept in over the years. Standard does not support optimizations so suddenly these beasts get out in the open. See [[BuildingMSVCStandard]]

For how to tune the MS IDE into coding OOo efficiently, see [[Editor_MSDev|this]] page.

=== Visual Studio 2008 Express ===

The compiler has been released on 11/20/2007.
Porting for this compiler has been started.

- under construction -

-obo

=== Visual Studio 2005 Professional ===

The necessary changes for configure haven't been made, yet.
It may help to set the environment variable PROF_EDITION=TRUE
by hand. When using the Vista SDK (03/22/2007, Rev. 6.1.6000.16384.10)
setting the environment variable WINDOWS_VISTA_PSDK=TRUE may help.
'''There are some issues with the Vista SDK see there, please.'''

The --disable-activex switch in the configure step is not needed for
the Professional Edition. The other steps should be the same as described
in the section for the Express compiler, but it hasn't been tested.

=== Visual C++ 2005 Express ===

[http://msdn.microsoft.com/vstudio/express/visualc Visual C++ 2005 Express] the '''FREE''' (as in free beer) Microsoft compiler is now supported for Windows builds. So, the great news is it's possible to build OpenOffice.org with a free Microsoft tool-chain.
See steps for using this compiler in the [[Windows#Using ooo-build]] section below. In fact I would guess the config options below will probably work for a vanilla OpenOffice.org build also ( maybe someone will try that and add any extra info/steps here ).

=== MinGW ===

[http://www.mingw.org/ MinGW] is gcc and GNU binutils targeted for Windows, producing plain Win32 executables. No POSIX emulation layer as Cygwin is involved. Using the Cygwin compiler with the -mno-cygwin switch in theory does the same, but unless one is very careful it is easy to get into a mess when using a Cygwin environment to build pure Win32 binaries.

MinGW is not supported for building OpenOffice.org at the moment.

Information about work to build OpenOffice.org with MinGW is at [http://qa.openoffice.org/issues/show_bug.cgi?id=24588 issue 24588] ; however this mostly deals with OpenOffice.org 1.1 at the moment.

Information about work to build OpenOffice.org 2 with MingGW is at [http://qa.openoffice.org/issues/show_bug.cgi?id=53572 issue 53572], [http://qa.openoffice.org/issues/show_bug.cgi?id=71986 issue 71986], [http://qa.openoffice.org/issues/show_bug.cgi?id=82653 issue 82653], [http://qa.openoffice.org/issues/show_bug.cgi?id=83133 issue 83133]

== Using vanilla source ==

While ooo-build has been developed to make building OOo less painful, you might also try to start out with the standard source code. After you download and unpack a vanilla ooo source tarball, running "configure" in the directory "config_office" will gladly complain about missing build-dependencies. The remaining build process is described in the document [http://tools.openoffice.org/dev_docs/build_windows_tcsh.html Building under Windows with tcsh]

== Using ooo-build ==

These are addenda to using ooo-build with the following command line:
./configure --with-win32

ooo-build should pick up all the other requirements for you automatically (reading them out of the registry)

=== Extra requirements ===

Here are some issues that require attention when building using ooo-build, and details not mentioned in the [http://tools.openoffice.org/dev_docs/build_windows_tcsh.html Building under Windows with tcsh] page:
* It is unclear whether using a ooo-build tarball will work. At least at some stage it didn't. Building from a checkout from (anonymous) SVN is known to work. You will then have to run autogen.sh.
* For some reason autogen.sh needs to be run through dos2unix, but none of the other shell scripts involved require this treatment.
* You should install also the Cygwin autoconf, automake, cabextract, diffutils, patchutils, pkg-config and wget packages
* You need to install the Perl module Archive::Zip using cpan. Just give the command "cpan", hit Enter to all questions, select the appropriate CPAN mirrors for your region, and give cpan the command "install Archive::Zip". Note: cpan will tell you that it is not up-to-date, and tell you how to upgrade itself, that is the Bundle::CPAN module. Please don't attempt to do that. It will bring in updates to a shitload of dependent Perl modules, try to build and install them, too, but the process will eventually fail miserably and you will end up with a non-working mess.
* The OpenOffice.org configure requires make version 3.80 in Cygwin. You must use that instead of the make 3.81 that Cygwin offers currently. For your convenience, there is a copy of make.exe here: [http://download.go-oo.org/tstnvl/tml/make.exe].

=== ooo-build with Visual C++ 2005 Express ===

The following steps were performed on a clean machine ( Win XP ) with no dev tools installed on it.

first review the information above

bits you need and where to get them ( as of Mon 6-Nov-2006 )

* [http://msdn2.microsoft.com/en-gb/express/aa700735.aspx visual c++ 2005 express edition ]

* [http://msdn2.microsoft.com/en-gb/express/aa700755.aspx Microsoft Platform SDK]

* [http://www.microsoft.com/downloads/details.aspx?familyid=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en platform sdk gdi+ ]

* [http://www.apache.org/dist/ant/binaries apache-ant-1.6.5 ] ( afaik this actually isn't needed for ooo-build but I autopiloted it in the configure, wont do any harm )

* [http://www.microsoft.com/downloads/details.aspx?familyid=7A1C9DA0-0510-44A2-B042-7EF370530C64&displaylang=en Microsoft Macro Assembler 8.0 (MASM) Package (x86) ]

* [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=CD1FC4B2-0885-47F4-AF45-7FD5E14DB6C0 Platform SDK Redistributable: Dbghelp.dll]

* [http://www.microsoft.com/downloads/details.aspx?FamilyId=D625324C-59B4-4951-849E-640B508DC442&displaylang=en DirectX Software Development Kit]

* [http://prdownloads.sourceforge.net/nsis/nsis-2.21-setup.exe NSIS]

* [http://download.microsoft.com/download/WindowsInstaller/Install/2.0/NT45/EN-US/InstMsiW.exe instmsiw.exe] and [http://download.microsoft.com/download/WindowsInstaller/Install/2.0/W9XMe/EN-US/InstMsiA.exe instmsia.exe] - put them in the $SRCDIR/external/msi directory

nice [http://tools.openoffice.org/servlets/ReadMsg?listName=dev&msgNo=6031 hints]
hints from Volker re. the config flags

'''Note''': in the configure flags shown below DirectX is disabled ( sorry at this point I was still waiting for it to download )

You need to copy msvcp80.dll and msvcr80.dll into your $SRCDIR/external/msvcp80 dir
in my case I found those libraries in

/cygdrive/c/WINDOWS/WinSxS/x86_Microsoft.VC80.CRT_1fc8b3b9a1e18e3b_8.0.50727.42_x-ww_0de06acd/msvc

had to downgrade the gnu make version from 3.81 to 3.80 ( apparently for building mozilla, but mozilla build failed anyway for me, I haven't had time yet to investigate further )

perform the manual header [http://tools.openoffice.org/servlets/ReadMsg?listName=dev&msgNo=6024 change] as described

Here's my configure as an example
<pre>
./configure --disable-build-mozilla --with-use-shell=bash --disable-activex --with-win32 --with-distro=NovellWin32
--with-tag=src680-m190 --with-cl-home="/cygdrive/c/Program Files/Microsoft Visual Studio 8/VC"
--with-csc-path="/cygdrive/c/WINDOWS/Microsoft.NET/Framework/v2.0.50727" --with-midl-path="/cygdrive/c/Program
Files/Microsoft Platform SDK for Windows Server 2003 R2/Bin" --with-frame-home="/cygdrive/c/Program
Files/Microsoft Platform SDK for Windows Server 2003 R2" --with-ant-home=/cygdrive/c/apache-ant-1.6.5
--with-jdk-home=/cygdrive/c/j2sdk1.4.2_13 --disable-directx --with-nsis-path="/cygdrive/c/Program Files/NSIS"
</pre>
compile problems:

* [http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites_on_the_1.7_and_1.8_Branches#Compiler_.26_Linker Building Mozilla 1.7.x with VC8 is not possible.] Just use the mozilla binary dist.

* lpsolve & scsolver didn't build ( these 2 are only relevant for only ooo-build with --with-distro-Novellxxxxx ) lpsolve has a minor problem with includes, in scsolver there are many template errors which I didn't investigate yet.

To disable temporarily either remove the CalcSolver label from the NovellWin32xxx sections in ooo-build/patches/src680/apply file or just use the generic PlainWin32 distro-target ( should work though I haven't tried that )

I got alot of problems with calls to remove where the call to remove includes std namespace. It seems that there is a precendent somewhere and maybe this at one time was known issue I opened this [http://www.openoffice.org/issues/show_bug.cgi?id=71404 issue] for that

I seem to get lots of "/usr/bin/bash: Resource temporarily unavailable" with my version of cygwin

<pre>
$ uname -a
CYGWIN_NT-5.1 trouble2 1.5.21(0.156/4/2) 2006-07-30 14:21 i686 Cygwin
</pre>

the following steps seemed to help or maybe the problem just went away by itself :-(
* reboot machine
* switch to tcsh e.g. do a 'tcsh' at the command prompt
* build from (the source tree)/instsetoo_native directory using the build --all command while in that directory
--[[User:Npower|Npower]] 11:42, 10 November 2006 (CET)

'''Note'''

The mozilla binary dist is linked against msvcr71.dll,msvcp71.dll. Therefore these librarys needs to be copied
into your $SRCDIR/external/msvcp71 directory before doing the configure step. You can get these from an OpenOffice
installation set.

'''Runtime requirement of installation sets'''

On sytems without an installed msvcr80.dll the vcredist_x86.exe has to be installed once first. This can be free downloaded at [http://www.microsoft.com/downloads/details.aspx?familyid=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=en Microsoft]

--[[User:obo|obo]]

== Building with Windows Vista SDK ==

Problems:
The Vista PSDK isn't complete. Several headers/librarys are missing: the whole ATL stuff, stgprop.h, adoctint.h.

Requirements (if you don't have the .NET 2005 Professional Edition):

* Download and install Windows Vista SDK (released on 3/22/07)
* Create stgprop.h in the PSDK include directory by copy/paste from MSDN forum [http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=508254&SiteID=1 here]
* Copy the winres.h header from Microsoft SDKs/Windows/v6.0/Samples/winui/tsfapp/winres.h to Microsoft SDKs/Windows/v6.0/include
* Install the runtime library version 8.0.5072.762 with vcredist_x86.exe. You can download it [http://www.microsoft.com/downloads/details.aspx?FamilyID=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en here]

Requirements (if you have the .NET 2005 Professional Edition):
* same as above, but add the include path of the compiler PSDK to the SOLARINC include path in following order: first Vista PSDK then compiler PSDK

=== Windows SDK V6.1 ===

* libxml2 breaks: redefinition of vnsprintf in config.h
* cppu/inc/uno/lbnames.h -> ms compiler version

-- under construction --

--[[User:obo|obo]]

== Miscellaneous info ==

* csc.exe comes from the c:\WINDOWS\Microsoft.NET\Framework\v1.1.4322 directory, you might need <tt>--with-csc-path</tt>.
* Beware of using <tt>/c/</tt> instead of <tt>/cygdrive/c/</tt>.
* Avoid trailing slashes in configure parameters. They sure cause problems for <tt>--with-psdk-home</tt>.
<ul>
<li>Using some not quite latest cygwin releases (1.5.18/1.5.19) can lead to tcsh freezing in places - the build will appear to hang. You can fix this by running ''ls /proc/$nnn/fd'' where $nnn is the number of the process. Or just run
<pre>
ls /proc/*/fd
</pre>
to "unhang" the process. See [http://www.openoffice.org/issues/show_bug.cgi?id=51560 issue 51560] for more info...

Noone so far created a reproducible hang that doesn't require the whole OOo environment, and to make it worse, there are those who cannot reproduce the hang at all ( Works fine here ;) ([[User:Vq]]) ). Until someone provides a recipe to reproduce this problem with a '''small''' testcase we have to hope that the cygwin developers accidentally fix this problem.
</li>
</ul>
* With cygwin 1.5.18, makecab.exe hangs when run from the build process (but it works fine when run standalone). So you definitely want to use a snapshot and '''avoid cygwin 1.5.18''', unless you enjoy wasting half a week of your life debugging like I did ...
* With later Cygwin versions (various 1.5.19 and 1.5.20 snapshots) hangs have been noticed at least by me ([[User:TorLillqvist]]) at various stages of the build on a hyperthreading (Pentium 4) machine, while doing the same build using the exact same Cygwin version on a single-processor machine worked fine. So it might be a good idea to turn off hyperthreading.
* If you get errors like "too long line in ddf file" during the MSI installer build this is caused by too long filenames. Try setting your TEMP/TMP environment variable to something short like "C:\tmp". There is a 255 char line limit for dds files and class names like "InvalidAuthenticationMechanismException" push the envelope. Shaving of 10-15 chars puts us back just under the limit.
<ul>
<li> '''Avoid using winzip''' to extract the downloaded source archive. Observed problems include:
* CR-LF errors that can affect makefiles and cause compile errors
* Certain files unpacked into root folder, esp. likely when actual path is deeply nested (e.g. foo/bar/source/foo/java/org/x/y/z/w/LongFileName.hmm) which again causes mysterious compile errors.
Use the tar from Cygwin instead:
<pre>
tar xvzf OOo_2.0.2_src.tar.gz
</pre>
</li>
</ul>
* If you fail to getting together a working installation of Cygwin, one possibility is to use a known-to-work combination of Cygwin packages, i.e. a direct copy of some other user's Cygwin tree. [[User:TorLillqvist]] has such a tree (from late 2006) zipped up at http://download.go-oo.org/tstnvl/tml/tml-cygwin.zip . Don't hesitate to ask for advice if necessary.

== See also ==

* To get started from scratch you most likely need to follow these steps (from the Linux version): [[Getting It]], [[Building]], [[Installing]], [[Running]]
* [[Windows Debugging]]
* [[Windows Tips]]
* [[Windows Installer Hacking]]
* [[SDKInstallation| How to install the SDK and compile the C++ examples]]

[[Category: Porting]] [[Category: Development]]