We just published an ASP.NET Core MVC Web Application that shows how to use the ReportingCloud Web API and the ReportingCloud Editor Widget to edit templates in any browser. This project is targeting .NET Core, is cross-platform and therefore, can be deployed to Windows, macOS, and Linux

The following screenshot shows this demo project:

ASP.NET Core Web Application

This very basic sample lists all templates located in your ReportingCloud template storage. When clicking on a template name, the template is loaded into the editor and saved back to your template storage when pressing the Save Template button.

How does it work?

The project uses TXTextControl.ReportingCloud.Core, the Microsoft .NET Core wrapper classes for Text Control ReportingCloud.

The Index action of the HomeController uses ReportingCloud to retrieve all templates using the Templates/List endpoint and returns this list to the view.

Loading...

In the view, a table is created based on the templates:

Loading...

When clicking on a template file name, the following JavaScript calls a controller method to load the selected template from the ReportingCloud template storage. The returned document is then loaded into the editor widget.

Loading...

The controller method Template uses the ReportingCloud Web API to retrieve the template and returns it as a Base64 encoded string that can be loaded into the editor.

Loading...

This project doesn't use any references to TX Text Control and uses only ReportingCloud functionality - completely cross-platform.

How to use the sample?

In order to use the sample project, you will need to perform some easy steps including the creation of a ReportingCloud account:

  1. Create a ReportingCloud account here:

    https://portal.reporting.cloud/account/register/

  2. In your Manage Account area, create an API Key:

    ASP.NET Core Web Application

  3. In the Widgets area, create a new widget location. If you are testing the sample project on your local machine from within Visual Studio, use localhost as the hostname:

    ASP.NET Core Web Application

  4. Click on Create Tag to create a customized JavaScript tag.

  5. Download the Visual Studio project from GitHub and open it in Visual Studio.

  6. Find the file appsettings.json, open it and add your API Key to the APIKey value. In our sample, this JSON looks like this:

    Loading...
  7. Find the file Index.cshtml in the Views -> Home folder, open it and add replace the JavaScript tag in line 7 with your created JavaScript tag:

    Loading...
  8. Compile and start the application.

We would love to hear your feedback about ReportingCloud and this cross-platform widget. Contact us to join the conversation.

GitHub

Download and Fork This Sample on GitHub

We proudly host our sample code on github.com/TextControl.

Please fork and contribute.

Requirements for This Sample

  • Visual Studio 2017 or better
  • ReportingCloud account (trial sufficient)