Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

RTI_BRWSupport is a helper routine that provides useful actions for the Banded Report Writer to perform.

Syntax

RTI_BRWSupport(Action, Param1, Param2, Param3, Param4, Param5, Param6, Param7)

Parameters

The function has the following parameters:

ParameterDescription

Action=LAUNCH

Starts up the Banded Report Designer.

Param1 - Param7

Not used.

ReturnsPath to the Banded Report Writer .NET assembly.

Action=READ

Reads and returns the specified report group definition.

Param1reportGroupName - Name of the report group.
Param2bLockFlag - Boolean flag to indicate whether the record should be locked.
Param3 - Param7Not used.

Returns

The XML definition of the specific report group from the SYSREPOSREPORTS table.
Special Note

The XML definition will be returned as a CR/LF delimited string even though OpenInsight stores this as an @FM delimited string. Swapping these delimiters might be necessary in order to use the definition in other commands.

The version and dynamic dictionary attributes will not be included in the report group definition.

Action=WRITEWrites a report group definition.
Param1reportGroupName - Name of the report group.
Param2reportGroupDefinition - The XML definition of the specific group to be written to the SYSREPOSREPORTS table.
Param3defaultReport - The report within the group that will automatically run unless a specific report is indicated.
Param4 - Param7Not used.
ReturnsEmpty string.
Special Note

This will create a new report group or it will update an existing report group as applicable. The underlying code attempts to perform a Repository("NEW"...) command first.

CR/LF delimiters will be swapped with @FM automatically so no prior corrective action is necessary (see the special notes for the READ action above.)

Action=DELETEDeletes the specified report group definition.
Param1reportGroupName - Name of the report group.
Param2 - Param7Not used.
ReturnsThe XML definition of the specific report group from the SYSREPOSREPORTS table.
Special NoteThe XML definition will be returned as a CR/LF delimited string even though OpenInsight stores this as an @FM delimited string.
Action=DISPLAYRuns and displays the specified report name from a specified report group using OIPI.NET.
Param1reportGroupName - Name of the report group.
Param2reportName - Name of the report from within the specified report group to display. (If this is omitted, then the default report for the report group will be displayed.)
Param3overrideListID - Name of the saved select list in the SYSLISTS table to use as a filter.
Param4rptDetails - Similar to the rptDetails parameter used by the RTI_BRW_GenerateReport function. This delimited array allows a specific printer and other options to be set:

<1, 1>      Printer name (as known by the Windows Print Manager) 
<1, 2>      Number of copies
<1, 3>      0 or "" for Portrait, 1 for Landscape
<1, 4, 1>  Left Margin (Hundreds of an inch, i.e., 100=1")
<1, 4, 2>  Top Margin (Hundreds of an inch, i.e., 100=1")
<1, 4, 3>  Right Margin (Hundreds of an inch, i.e., 100=1")
<1, 4, 4>  Bottom Margin (Hundreds of an inch, i.e., 100=1")
<1, 5>      Page size code
<1, 6>      Print Preview caption.*
                (*Only available in OI v10, otherwise, not applicable.)
Param5 - Param7Not used.
ReturnsEmpty string.
Special NoteThis is the same as using the LOADREPORT message for the Set_Printer function except that there does not appear to be support for the Append feature.
Action=REPORTSReturns an @VM delimited list of report groups for the current application.
Param1 - Param7Not used.
ReturnsAn @VM delimited list of report groups for the current application.
Action=LISTReturns an @VM delimited list of report for the specified report group.
Param1reportGroupName - Name of the report group.
Param2 - Param7Not used.
ReturnsAn @VM delimited list of report for the specified report group.
Action=DEFAULTReturns the default report from the specified report group.
Param1reportGroupName - Name of the report group.
Param2 - Param7Not used.
ReturnsThe default report from the specified report group.
Action=KILLCloses the Banded Report Designer.
Param1 - Param7

Not used.

ReturnsEmpty string.

See Also

RTI_BRWSupport