Seddryck / NBi

NBi is a testing framework (add-on to NUnit) for Business Intelligence and Data Access. The main goal of this framework is to let users create tests with a declarative approach based on an Xml syntax. By the means of NBi, you don't need to develop C# or Java code to specify your tests! Either, you don't need Visual Studio or Eclipse to compile your test suite. Just create an Xml file and let the framework interpret it and play your tests. The framework is designed as an add-on of NUnit but with the possibility to port it easily to other testing frameworks.
http://www.nbi.io
Apache License 2.0
107 stars 37 forks source link

Run a simple example in visual studio 2019 and SQL-Server 2019 #622

Open AmirNBA9 opened 3 years ago

AmirNBA9 commented 3 years ago

I like use you framework but I need help to run a simple example for better understand how to work. you document very good and complete, but don't have UML or process flow.

I tried run nbi project for unit test SSIS package.

I have 2 problem for run a simple example :

  1. document not enough clear for new user like me (do you have training example by full of data we need. Like a simple package for fill one column in source to destination)
  2. Nunit project don't have .exe file and need run by visual studio. (Please add windows app and check not found links in document)
Seddryck commented 3 years ago

NBi is not a commercial project but a community project. It means that contributors are providing most of the contributions to the code, to the documentation, to the blogs, to the conferences or webinars during their free time without financial compensation. Having more users is not our end-goal. If we've the choice between spending time on a video on installation or a new feature, we're usually selecting the second option. Is it stupid in terms of user adoption? Surely!

We would be pleased to know what is not clear (or not supported anymore but not removed from documentation) to improve this documentation but you need to be more precise. Where do you struggle? don't tell use how it would be cool to have a great documentation, explain us precisely where you don't get it ... or you could be sure that the video will do an ellipsis on this point. Personally, I know really well that the first configuration of NBi could be troublesome and that it is not the easiest task. We tried to improve this in many ways over the years but apparently, we're still not there. Most of us struggle with our first project but finally succeed and then just copy/paste the configuration for the next project.

Is it specific to NBi or to community-driven open-source projects? Not really, yesterday I struggled 60 minutes to understand why a PowerShell module was exporting none of my functions. Learning a new language/framework/library/... is not easy tasks and could be really frustrating at the beginning. Usually, the best tutorials are written by newbies and we'd really enjoy that someone in that position contributes to the documentation.

Before going really inform, NBi is not compatible with SSIS running on SQL Server 2019. That's still on the to-do list.