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.

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