source: trunk/autoquest-plugin-html/src/main/resources/manuals/parseHTML @ 2276

Last change on this file since 2276 was 1894, checked in by pharms, 10 years ago
  • added support for mapping document paths and removing their queries
File size: 3.3 KB
Line 
1Parses an HTML log file them into an event sequence and a GUI model.
2
3The parsing process can be parameterized. This allows to replace ids or ignore indexes of GUI elements in the log files. If they are replaced or ignored, the GUI model is more harmonized and GUI elements are considered equal although they are not. This may be helpful, e.g., if you have a table where each row is semantically the same. Without ignoring indexes or ids of the rows, each row is treated separately. But with ignored or replaced indexes or ids, all rows are considered the same.
4
5The parameterization is done in a separate properties file. The keys in the file specify the tags for which either the id shall be replaced or the index shall be ignored. A specification for a simple tag either simply by its name, by its name and index or by its name and id looks as follows:
6
7tagName
8tagName[index]
9tagName(htmlId\=id)
10
11Furthermore, tags can be specified as paths through the DOM in that several tags specifications are given and concatenated using /. An example with three specified tag (tag1 with index 5, tag 2, and tag 3 with id "id") is the following:
12
13tag1[5]/tag2/tag3(htmlId\=id)
14
15The specification of a tag id may contain the # character to denote a wildcard. This allows matching several GUI elements with similar ids at once and to give them the same id. An example entry of this is:
16
17div(htmlId\=id_number_#)
18
19This line would match all divs with an id starting with "id_number_" where # denotes any character.
20
21It is also possible to specify the document in which the tag path should match. A document is specified by giving a part of the documents path in the URL. After the document specification, the full path to the specified tag must be given. An example is the following:
22
23document(path\=accounts)/html/body/div[0]/ul/li(htmlId\=breadcrumb1)/a
24
25Please note that for specifying the keys, it is required to escape any = sign in the key specification. This is usually required if the path to the denoted GUI elements denotes elements by their id as shown in the example.
26
27To remove the id of a specified tag, the value must be empty. To set the id, the value must be the id the tag shall have. To clear the index of the specified tag, that value must be CLEAR_INDEX. Here are some further example entries:
28
29body/div/div/div/form=
30body/p/small/a=imprint-link
31document(path\=accounts/login)/html/body/div[0]/div[1]/div[0]/form/p/a=password-reset-link
32document(path\=accounts/login)/html/body/div[0]/div[1]/div[0]/form/div/button=CLEAR_INDEX
33body/div[5]=date-chooser
34div(htmlId\=date-chooser)/div[0]=date-chooser_day
35
36It is also possible to set a new path for a document and to clear queries belonging to the paths of the documents. Examples for this are:
37
38document(path\=/pathToPage/)=CLEAR_QUERY
39document(path\=/pathToOtherPath)=new/path
40document(path\=/pathTo/Page/withQuery/=CLEAR_QUERY,new/path   (clears the query and changes the path at once
41
42For path specifications, also wild cards are allowed. To denote the end of a path, the $ sign can be used.
43
44
45$USAGE$
46
47<file>
48    path to the file to be parsed
49[<sequenceNames>]
50    array of sequences into which the parsed events shall be stored
51{-parseParams=path/to/replacementfile}
52    used to define id replacements as described in a separate file
53
54Example(s):
55parseDirHTML /path/to/file.log
56parseDirHTML /path/to/file.log sequences -parseParams=idReplacements.txt
Note: See TracBrowser for help on using the repository browser.