Creating a Convert to HTML Step

This step parses log files on the Deployment Automation agent side and provides an HTML file containing log contents and search results.

Required properties:

Property Name	Description
Include Files	Specify the list of files to parse, relative to the base directory. Wildcards can be used. Specify multiple file paths as a new-line-separated list. Default value: `${p:prevStep/logPath}`
Output Path	Specify the output file path for the resulting HTML file.
Rules	Specify a new-line-separated list of rules to apply to the contents of the file. The rule format is: `RuleName=RegularExpression` `RuleName` is the name of the rule to assign to a line if the line matches the regular expression specified in `RegularExpression`. For example, `ORA_MESSAGES=ORA-\d\d\d\d` will find all the lines containing the regular expression `ORA-\d\d\d\d` and assign it to the rule name `ORA_MESSAGES`. Rules will be applied to each log line in the order of appearance in this field.

Property Name

Description

Include Files

Specify the list of files to parse, relative to the base directory. Wildcards can be used. Specify multiple file paths as a new-line-separated list. Default value: ${p:prevStep/logPath}

Output Path

Specify the output file path for the resulting HTML file.

Rules

Specify a new-line-separated list of rules to apply to the contents of the file. The rule format is: RuleName=RegularExpression

RuleName is the name of the rule to assign to a line if the line matches the regular expression specified in RegularExpression.

For example,

ORA_MESSAGES=ORA-\d\d\d\d

will find all the lines containing the regular expression

ORA-\d\d\d\d

and assign it to the rule name

ORA_MESSAGES.

Rules will be applied to each log line in the order of appearance in this field.

Optional properties:

Property Name	Description
Base Directory	Specify the root directory where log parsing will be done.
Exclude Files	Specify the list of files to exclude from selection, relative to the base directory. Wildcards can be used. Specify multiple file paths as a new-line-separated list.
Group By	Select the way you want the output to be grouped. Values are: None Group name File path
Output Format	Specify the output format of each line in the output log. Special properties can be used in this field. Each special property should be specified in the following format: `${propName}` Allowed properties: Line LineNumber FileName FilePath GroupName RegExp Default value: `\t${FileName}:${LineNumber} - ${Line}`
Fail If No Files Found	Select this to cause the step to fail if no files are found that match the include and exclude file filters in the base directory. Default value: Not selected
Set Colors	Specify the list of highlight colors to apply to the corresponding rules. The format of the field is: `RuleName` where RuleName is the name you assigned in the Rules property. You can set one color per rule. Colors should be specified in hex format. For example: ERROR=#FF0000 WARNING= #FF8040 SUCCESS=#008000