CM-Cabinets Library User Guide
In This Topic
    RDL Report Design
    In This Topic

    Be aware that editing and designing your own report is not part of support.

    Contact your local Sales Representative if you would like a customised report created by our CabMaster team, as fees apply.

    Requirements

    Software

    Knowledge

    Reporting information should come from tables and CabMaster Drawing properties.

    CabMaster will only export the information requested by the report unless otherwise specified with the AMSFilter parameter.

    Make sure fields are correct before editing a report, as they will not update automatically if they change whilst designing the report.

    See Designing RDL Reports below for information about designing and formatting RDL / SSRS reports.

     

    Generating MDB Report

    Follow the following steps to generate a MDB (Microsoft Access Database) report.

    1. Open CabMaster.

    2. Place cabinets that are representative of the cabinets to be reported on.

    3. Download the Sample Report here and place in <your CabMaster>/Report folder.

    4. Run the Sample Report from the File menu.

      File > Report > Report

    5. Open the <your CabMaster>/Report/TempReportData folder.

      Example

      Click to view contents of TempReportData folder i.e. mdb file

      Click to view contents of TempReportData folder i.e. mdb file

    6. CabMaster will have created a TempReportData.mdb containing all of the reporting information.

     

    Connecting a New Report to the MDB

    1. Open Microsoft Report Builder;

    2. Select New Report;
    3. Select Blank Report;

    4. Right click on Data Sources and select Add Data Source...

    5. Select Use a connection embedded in report;

    6. Select OLEDB in the Connection Type dropdown;

    7. When writing and testing a report in Report Builder enter the following connection string (<YourPath> will be replaced in Step 8);

      Connection String

      Provider=Microsoft.Jet.OLEDB.4.0;Data

      Source=<YourPath>\CabExportData.mdb;User Id=admin;Password=;

    8. When releasing the report for use replace the connection string with path to the TempReportDataMDB ...

      Amend path of the Connection String

      Replacing <YourPath> with the path to the TempReportDataMDB

      Provider=Microsoft.Jet.OLEDB.4.0;Data

      Source=.\TempReportData\CabExportData.mdb;User Id=admin;Password=;

    9. Press the Test Connection button.

    10. If the connection string’s path is correct you will see the following popup.

     

    Setting up a DataSet

    1. Right click the DataSets tab and select Add DataSet...

    2. Give it a name e.g. CabMasterData;

    3. Select Use a data set embedded in my report;

    4. Select your Data Source from the list;

    5. Enter your SQL query in the text box and press Refresh fields;

      Sample Query

      SELECT Item.id, Item.label, Component.Comment, Component.displayname,

      Component.dimname1, Component.dim1, Component.dim2, Component.dim3 FROM

      Component INNER JOIN Item ON Component.id = Item.id

    6. The corresponding fields will be generated in the Dataset and can be used to populate the report.

     

    Parameters

    CabMaster Drawing Property names are required for this section and are located by hovering over the required option - see RDL Property Names.

    In this example we will use the Property Name on the Job Setup > Client page.

    1. Right click on the Parameters tab and select Add Parameter...

    2. Enter the Property Name in the Name field:

    3. Enter the Property Name in the Prompt field:

    4. Select Allow Blank;

    5. Go to Default Values;

    6. Select Specific Values;

    7. Click Add;

    8. Enter the Default value;

     

    CabMaster Images in Report

    To add images from CabMaster into your report, you need to :-

    1. Add a parameter called AMSImages to the report;

    2. Set the parameter to Allow Blanks and Allow Nulls;

    3. Set the parameter's visibility to Internal;

    4. Add a specific Default Value for the image you require;

      • (in this example Ortho=600 specifies Ortho images at 600x600 Px)
    5. Add a Second Parameter (repeat Step 1 to 3) called ReportPath;

    6. Set the parameter to Allow Blanks and Allow Nulls;

    7. Set the parameter$'s visibility to Internal;

    8. Add an Image Type to the report (in this example Ortho is added). Refer to images using the following :

       ="file:"&Parameters!ReportPath.Value&"\TempReportData\OrthoImages\"&cstr(CabinetID)&". png"

    Replace CabinetID with the field that corresponds to the cabinet's id, as discussed next.

     

    Image Types

    In the following references replace CabinetID with your DataSet field for the cabinet's id.

    Plan

    Reference using :-

        ="file:"&Parameters!ReportPath.Value&"\TempReportData\PlanImages\"&cstr(CabinetID)&".png"

    AMSImage value : Plan=600

    Example

    Elevation

    Reference using :-

        ="file:"&Parameters!ReportPath.Value&"\TempReportData\ElevationImages\"&cstr(CabinetID)&".png"

    AMS Image value : Elevation=600

    Example

    Side

    Reference using :-

         ="file:"&Parameters!ReportPath.Value&"\TempReportData\SideImages\"&cstr(CabinetID)&".png"

    AMSImage Value : Side=600

    Example

     

    Ortho

    Reference using :-

         ="file:"&Parameters!ReportPath.Value&"\TempReportData\OrthoImages\"&cstr(CabinetID)&".png"

    AMSImage Value : Ortho=600

    Example

    Wireframe

    Reference using :-

        ="file:"&Parameters!ReportPath.Value&"\TempReportData\WireFrameImages\"&cstr(CabinetID)&".png"

    AMSImage Value : Wireframe=600

    Example

    Hidden

    Reference using :-

       ="file:"&Parameters!ReportPath.Value&"\TempReportData\HiddenImages\"&cstr(CabinetID)&".png"

    AMSImage Value : Hidden=600

    Example

     

    Solid

    Reference using :-

       ="file:"&Parameters!ReportPath.Value&"\TempReportData\SolidImages\"&cstr(CabinetID)&".png"

    AMSImage Value : Solid=600

    Example

     

    Textured

    Reference using :-

       ="file:"&Parameters!ReportPath.Value&"\TempReportData\TexturedImages\"&cstr(CabinetID)&".png"

    AMSImage Value : Textured=600

    Example

     

    Machining

    In the following reference replace FullID with your DataSet field for the Component.IdFull.

    Reference using :-

       ="file:"&Parameters!ReportPath.Value&"\TempReportData\MachiningImages\"&cstr(IDFULL)&".png"

    AMSImage Value : Machining=600

    Example

     

    Special Parameters

    ReportPath

    Returns the path to the report directory. Parameter's used for placing images in reports.

    Parameters

    AMSFilter

    Optionally restricts/extends the data sent to the MDB. By default, CabMaster looks at the SQL statement in the report and generates all tables/fields that are referenced in the SQL. But you may want to provide additional tables/fields in the MDB data, particularly during report development so you can select from more fields.

    AMSFilters includes wildcards (e.g *.*).

    Parameters

    AMSImages

    Tells CabMaster what images and what resolution to output them as. For available options see Image Types discussed above.

    Parameters

     

    Microsoft : Designing RDL Reports

    For information about designing and formatting RDL / SSRS reports please visit the following links:

    Report Builder Tutorials

     https://docs.microsoft.com/en-us/sql/reporting-services/report-builder-tutorials?view=sql-server-ver15

    Installing Report Builder

     https://docs.microsoft.com/en-us/sql/reporting-services/install-windows/install-report-builder?view=sql-server-ver15

    SSRS Documentation

    https://learn.microsoft.com/en-us/sql/reporting-services/create-deploy-and-manage-mobile-and-paginated-reports?view=sql-server-ver15

    SSRS Forums

    https://social.msdn.microsoft.com/Forums/sqlserver/en-US/home?forum=sqlreportingservices

     

    See Also