fyiReporting Software, LLC
Report Properties
- Author
- The author of the report. Used by some renders (e.g. PDF) for outputing the author information.
- Description
- Use is dependent upon the renderer chosen. For example, the HTML render uses this as the Title element.
- Width
- The width of the report.
- Page Width/Height
- The page height and width of the report. Controls the visual size of the .Net viewer and PDF page.
- Margins
- Controls the margins of the report.
- Page Header
- You can optionally control whether the page header prints on the first or last page.
- Page Footer
- You can optionally control whether the page footer prints on the first or last page.
- Add/Remove buttons
- Allow you to add and remove properties from the list.
- Name
- The name provided must be unique amoung all parameters.
- Prompt
- The text shown when prompting the user for a value.
- Allow Null
- Specifies whether it is legal to have a null for the parameter value.
- Allow Blank
- For strings specifies whether an empty string is allowed.
- Default Values
- The value that will be used when no user value has been provided. This can either provided either by a values list or a DataSet. Current limitations restrict you to providing only one value.
- Valid Values
- These are the allowable values for the parameter. These will be shown in a list for the user to pick from. This can either be a list of values or a Dataset that provides both the value and the cooresponding display value.
-
The following properties apply when generating XML.
- XSL Data Transform
- The XSL data transformation file that should be used after creating the initial XML.
- Data Schema
- The data schema of the result XML.
- Top Element Name
- The top most element name.
- Element Style
- This is either Attribute or Element.
- Height
- Height of the body of the report. This height is frequently adjusted by dynamically sized report items like lists, tables, and matrixes.
- Columns
- The number of columns. If there is more than 1 column in the body, then after filling a page (top/down) instead of moving to the next page a new column will be introduced. The width of a column is the report width. This is useful when creating reports for labels.
- Column Spacing
- The spacing between multiple columns.
- Check Syntax button
- Verifies the code will compile correctly. If there are errors, you can click on the message and the line in error will be highlighted.
- Syntax
- Any valid VB syntax is allowed. For example the RandomQuote
function can be used in report expressions by coding 'Code.RandomQuote()'.
' Get a random quote Dim aRand As New Random Public Function RandomQuote() As String Select aRand.Next( 4 ) Case 0 Return "All's well that ends well" Case 1 Return "A stitch in time saves nine." Case 2 Return "To be or not to be, that is the question" Case 3 Return "In for a penny, in for a pound" End Select End Function
- Code Modules
- Put any DLL names in the list that you need access to when running the report. Any public static functions will be available for use within the report. You should fully qualify the function name to ensure you get the correct function. When looking up a function the arguments to that function figure into the signature of the method. That is, the function name and argument types must match a known method and its arguments.
- Instance variables
- These instance variables will be created just prior to the report being run. You reference instance variables in the report using the instance name dot the function and arguments. For example, 'instvar.Function1(arg1, arg2)'.