Skip to main content

Linked reports with NRapid

Being able to link reports it’s really handy feature that usually the end users of our system will love it.
For instance, you can create a report that that displays order’s headers and when the users click on the order’s id, he/she can see a child report with the order’s detail.

In this case I’m going to work with categories and products but the technique can be applied to any master-detail scenario.

First of all we need to create a report that shows the list of categories (we already did that in a previous post, so I’m not going into details here) and then somehow link this report with a report that show a list products for a specific category.

This might sound complex, but with NRapid is pretty straightforward and only will take you just a line of code inside the configure method:






*There’s also a cool feature inside NRapid reports that allows us to run arbitrary c# code when the user clicks a link but this feature deserves his own post ;)

What does this code does, well, basically it tells to the report engine that the cells inside the column “Cat. Id” are special and must associate callbacks to them, this will give us the ability to handle the user click.

If you execute the report, you will see that now the category’s ids are links not plain text.




















In our case, those links (callbacks) will being pointing to the method ShowProductsByCategory wich we will be using to execute the child report (in this case, products by category). The code to do that may look something like this:







If you take a look at the code, you’ll see that category’s Id was magically passed to our callback method. In future posts I’ll be covering some of the internals of NRapid and we will take a deep dive into those kinds of tricks.

When you run the report, you should see something like this:

In the next post I'll show you how to add footers to our reports.

You can get the source code of NRapid from here
And the sample app from here
The Northwind database is available from download at http://www.microsoft.com/en-us/download/details.aspx?id=23654

Comments

Popular posts from this blog

Moving to Medium

It's been a long time since I want to give medium a try, and finally, I made some time to do it. To get started on the new platform, I'll be doing series on "Getting programming concepts, languages and tools". If it sounds interesting to you, please take a look at the first post  Getting AWK  and spread the word if you like it. I'm not going to migrate old entries to the new web site. They will remain here safe and sound! As usual, thanks for reading!

Working with unattended reports

In this post I‘ll show you how to create reports that NRapid will execute into an unattended mode. I strongly recommend using this kind of reports in automation scenarios only , and let the user see the print preview dialog in the rest of cases. The only difference between this reports and the standard ones, is that you will cannot make use of dialogs, the runtime will always pass in empty views to the ConfigureReport method. The ConfigureReport method will be executed, but you will have to grab the arguments from somewhere else. The execution pipeline is the same that NRapid uses for standard reports. This is the code to print out the whole list of categories in a dialogless mode. Notice that this report inherits from UnattendedReport class, this class tells to NRapid “run the report unattended”. Also notice that this class comes with a convenience method to configure the report with no arguments. You still can override the one that gets the view data but you will always

How to create MS Word documents from Office templates using C#

The OpenXML SDK allows you to do pretty much anything you want with office files such as Excel, Word, etc… While many people like this library, I found it complex, unintuitive and poorly documented, not to mention the awful xml format that uses under the hood to represent the documents, styles, etc. So I decided not to use it and build my own solution. If you, like me, don’t like that library, you will find in this post an alternative approach to build word documents from templates using c#. A neat trick to work with Office is to use the macro recorder to understand how things work. The macro recorder allows you to start a macro, do something by hand, stop it, and then take a look at the generated VBA code. Once you do this, you are pretty much set. This is how it looks the template I’am going to use. Note: save the file as a Word template (.dotx) This is the code to create Word documents from C#: By running the code, you should get a document that looks