Blueprint Forge provides a simple, coding-free way to build cumulocity application using pre-built solution templates. Blueprint Forge is an open-source Cumulocity Blueprint that empowers you to initially build an application from a template and later enhance it with additional plugins, dashboards, branding and much more. It's being managed by the Software AG's open-source community but not officially supported by Software AG. You can log any issues at GitHub or ask any question on the Software AG Tech Community. Support will be provided on best endeavours.
Discover, Learn, Excel: Access How-To Video and Demos at a Glance!
- Multiple Welcome Templates: Now user can select Welcome Dashboard while creating application. Choose from a variety of Welcome Templates tailored to your needs.
- Tailor Your Simulation: Select the Dashboard template to create simulator or use our pre-configured one.
- Link Device from Dashboard: Link Device with a Click to Another Dashboard.
- Configure Your Dashboard: Configure your dashboard by assigning Actual Device or Simulating it.
- Add Custom Dashboard: Now user can select pre-built templates for custom dashboards.
- Enhanced Dashboard Catalog: Users can now select and filter dashboard templates, as well as create simulators directly from the Dashboard Catalog.
- Share Dashboards: Share and Reuse. Add your Custom Dashboards to the Catalog by using "Add to Catalog" button and Share it within Tenant or export and use it in other tenants.
- DTDL Generator Plugin: New DTDL plugin to generate DTDL or simulator configuration files based on existing device and measurements.
- Dashboard Template Preview: Now user can see the preview of various Dashboard Templates while creating the application.
- Various bug fixes
- Solution Templates: Blueprint Forge support template-driven approach which enable delivery and maintenance of pre-built solution templates with a seamless user experience. As in initial version, we have Field Services, Predictive Maintenance and Demo Template as our pre-built solution templates.
- Easy Customization: Simplified customization to configure dashboard, devices, widgets and microservices.
- Dashboard Catalog: User can select any pre-designed template for dashboard and ability to install dependent widgets.
- Installation of plugins and microservice: Provides option to install plugins and microservices while creating an application.
- Provision to add essential dashboards: Effortlessly Craft Applications Using Demo Template's Essential Dashboards and Features – Explore the Overview, Receive a Warm Welcome, Find Help and Support.
- Blank Template support: The Blank Template Lets You Build Applications from Scratch, No Dashboards or Plugins Preselected.
- Support for Device group and Asset Type: Link not just devices, user can also link Device Group and Asset type with the dashboard.
- Configure while creating: User can configure the application while creating it.
- Custom Branding: Provides flexibility and control over application’s look and feel. Now user can use color picker to choose millions of colors to customize branding. Header, Action bar and tab bar are also customizable. User can add his own branding by choosing different colors of his choice in the application.
- Configure Simulator: Configure the simulator as desired, or we can also auto-configure based on the selected dashboard template.
- Link Device from Dashboard: Map devices from another dashboard by choosing the dashboard to link with.
- Select Dashboard Template: Now you can choose a template for your dashboard, it will include all the details from the selected template.
- Add Custom Dashboard: Add a custom dashboard where you can customize which devices to link and also choose the dashboard template.
- Generate DTDL: Generate DTDL file or Simulator configuration file effortlessly based on existing device measurements and simulate real device behaviour within the same or different tenants. For more information about DTDL Generator. Refer DTDL Generation
- Enhanced Dashboard Catalog: Effortlessly find various dashboard templates tailored to your needs. With intuitive search functionality, selecting the perfect dashboard template has never been easier. You can now also create simulator directly from Dashboard Catalog.
- Share Dashboards: Effortlessly share and reuse your customized Dashboards within your own tenant or across different tenants. Now, easily add your personalized Dashboards to the catalog for seamless access using "Add to Catalog".
- Grab the Latest Release Zip
- Go to the Administration view in your tenant (/apps/administration)
- Open the Ecosystem section in the navigator
- Go to Extensions
- Click Add Exctension Package
- Drop zip file or select from your system location.
- Click Done
- Grab the Latest Release Zip
- Go to the Administration view in your tenant (/apps/administration)
- Open the Ecosystem section in the navigator
- Go to Extensions
- Click Blueprint Forge
- Click "Versions"
- Drop zip file or select from your system location.
- Click Done
This guide will teach you how to create your first application using the Blueprint Forge.
NOTE: This guide assumes you have followed the Installation instructions
- Open the Blueprint Forge package which was installed (refer to Installation step)
- Click
Deploy application - Enter the application details and click
Save
You have created an application.
- Navigate to the application created.
- Click on Open and you can see the welcome screen.
- Click on
Start. - You will see the list of templates, click any of the template using which you want to create an application.
- You will see the details page, click on continue.
- Select the dashboards, plugins and microservices of you choice.
- Fill the device details if it is required by the dashboard.
- You can also fill the configuration for the widgets if needed.
- Click on
Continue. - It will take a while to install the dependent packages. Then click on
Save and Reload.
Congratulations! You have successfully created an application using Blueprint Forge with template of your choice.
Blueprint Forge application can be upgraded if new version update is available. If newer update is available, an icon (on hover of it, it shows "Update available") is seen next to the application version below the application name.
Follow below steps to upgrade your application:
- Go to Applications -> All applications.
- Click on the Blueprint Forge application name which is created. You will be navigated to Application Properties.
- You will see "Update available" button in the Properties. Click on it.
- Pop up appears for confirmation. Click on "Update" to upgrade your application.
Congratulations! You have successfully updated your application. You can see the latest version next to your application name.
Blueprint Forge provides various options and flexibility while you create your application. You can configure your device, simulate it or also link device of another dashboard.
- Go to Extensions -> Click Blueprint Forge.
- Click on Deploy application. Edit application name and other details if required.
- Click on Open and open the created application.
- Click on Start -> Choose the template and click on Continue.
- You will be navigated to Details step. Click on continue.
- In this step you can choose Welcome template from various templates available and can edit the Application Configuration.
- Click on Continue.
- In the Connect step, you can configure Devices/Simulators/link your dashboard with another. You can also proceed with default configuration.
- In case of Device:
- Click on Device icon and select Device/Group/Type.
- Select the dashboard template of your choice.
- In case of simulator:
- Click on Simulator icon and fill the Group name and Number of devices field.
- Select the Dashboard template of your choice.
- In case of Link Dashboard:
- Click on Link icon.
- Select the Dashboard (the dashboard will have same device of link dashboard which you choose) and select the Dashboard template of your choice.
- You can also proceed with default configuration provided within this step.
- Click on Continue. All the necessary plugins/microservices and other dependencies will be installed required for the dashboards.
- Click on Save and reload.
Congratulations! You have successfully created an application using Blueprint Forge with template of your choice.
For more details, please visit our Step-by-Step How-To Video Guide.
The Blueprint Forge provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.
For more information you can Ask a Question in the TECH Community Forums.