{"id":13691612,"url":"https://github.com/SoftwareAG/cumulocity-power-bi-widget","last_synced_at":"2025-05-02T15:32:43.239Z","repository":{"id":50457151,"uuid":"461806725","full_name":"SoftwareAG/cumulocity-power-bi-widget","owner":"SoftwareAG","description":"This widget helps to display reports from Power BI. Developed by Global Presales.","archived":false,"fork":false,"pushed_at":"2023-08-18T04:32:45.000Z","size":2838,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T04:53:18.996Z","etag":null,"topics":["accelerator","cumulocity","cumulocity-iot","iot","iot-analytics","powerbi","presales","reporting","reporting-tool","widget"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SoftwareAG.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-02-21T10:17:09.000Z","updated_at":"2022-04-29T13:27:12.000Z","dependencies_parsed_at":"2024-04-08T11:02:47.621Z","dependency_job_id":null,"html_url":"https://github.com/SoftwareAG/cumulocity-power-bi-widget","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fcumulocity-power-bi-widget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fcumulocity-power-bi-widget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fcumulocity-power-bi-widget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftwareAG%2Fcumulocity-power-bi-widget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SoftwareAG","download_url":"https://codeload.github.com/SoftwareAG/cumulocity-power-bi-widget/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252063124,"owners_count":21688652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accelerator","cumulocity","cumulocity-iot","iot","iot-analytics","powerbi","presales","reporting","reporting-tool","widget"],"created_at":"2024-08-02T17:00:47.446Z","updated_at":"2025-05-02T15:32:38.751Z","avatar_url":"https://github.com/SoftwareAG.png","language":"TypeScript","funding_links":[],"categories":["IoT \u0026 Analytics"],"sub_categories":["![cumulocity_64x64](https://user-images.githubusercontent.com/23717841/230378694-959dcc10-00ef-4e6a-ad4b-d1a13cec5f6d.png) Cumulocity IoT"],"readme":"\n# Power BI Widget for Cumulocity [\u003cimg width=\"35\" src=\"https://user-images.githubusercontent.com/67993842/97668428-f360cc80-1aa7-11eb-8801-da578bda4334.png\"/\u003e](https://github.com/SoftwareAG/cumulocity-power-bi-widget/releases/download/v1.0.0/powerbi-runtime-widget-1.0.0.zip)\n\n  \n\nThe Power BI widget help you to display reports created from data offloaded from DataHub seamlessly in application.\n\n  \n![Power_BI](https://user-images.githubusercontent.com/99970126/181720578-e55d7911-bad6-4932-a27c-14232d1647b3.png)\n\n![Power_BI_Config](https://user-images.githubusercontent.com/99970126/181721134-5517d55a-56fe-4eff-8073-37e3559914b2.png)\n\n\n\u003e ### ⚠️ This project is no longer under development. Please use [Power BI Widget Plugin](https://github.com/SoftwareAG/cumulocity-power-bi-widget-plugin) for Application Builder \u003e=2.x.x and Cumulocity \u003e=1016.x.x⚠️\n\n  \n\n### Please verify that you are using below Application builder version:\n\n  \n|APPLICATION BUILDER | CUMULOCITY | POWER BI WIDGET    |\n|--------------------|------------|------------------------|\n| 1.3.x              | \u003e= 1011.x.x| 1.x.x                  |\n\n  \n  \n  \n\n## Features\n\n  \n*  **DataHub Integration :** Seamless data visualization from DataHub using PowerBI workspace and report selection.\n\n*  **PowerBI Configuration:** Ability to configure various PowerBI report options.\n\n*  **Workspace Selection:** Ability to select the workspace.\n\n*  **Reports:** Select the respective report from list of available reports under the workspace selected.\n\n\n## Prerequisite\n   * DataHub should be subscribed, configured and installed in the tenant.\n   * Reports should be created in PowerBI and you should have connection for PowerBI configured in DataHub.\n\n* Minimum Permission needed:\nDataHub_Manager\n\n* For more information on DataHub,click here:\nhttps://cumulocity.com/guides/datahub/datahub-overview/ \n\n## Installation\n\n\n### Runtime Widget Deployment?\n\n  \n\n* This widget support runtime deployment. Download [Runtime Binary](https://github.com/SoftwareAG/cumulocity-power-bi-widget/releases/download/v1.0.0/powerbi-runtime-widget-1.0.0.zip) and use Application-builder to install your widget.\n\n  \n\n### Installation of widget through AppBuilder\n\n  \n\n**Supported Cumulocity Environments:**\n\n  \n\n*  **App Builder:** Tested with Cumulocity App Builder version 1.3.0\n\n  \n\n**Requirements:**\n\n  \n\n* Git\n\n  \n\n* NodeJS (release builds are currently built with `v14.15.0`)\n\n  \n\n* NPM (Included with NodeJS)\n\n  \n\n**External dependencies:**\n\n  \n\n```\n\"@powerbi-client\": \"^2.19.1\",\n```\n\n  \n\n**Installation Steps For App Builder:**\n\n  \n  \n\n**Note:** If you are new to App Builder or not yet downloaded/clone app builder code then please follow [App builder documentation(Build Instructions)](https://github.com/SoftwareAG/cumulocity-app-builder) before proceeding further.\n\n  \n  \n  \n\n1. Open Your existing App Builder project and install external dependencies by executing below command or install it manually.\n\n  \n\n```\nnpm i powerbi-client@^2.19.1\n```\n\n2. Grab the Power BI Widget **[Latest Release Binary](https://github.com/SoftwareAG/cumulocity-power-bi-widget/releases/download/v1.0.0/gp-powerbi-widget-1.0.0.tgz)**.\n\n  \n  \n\n3. Install the Binary file in app builder.\n\n  \n\n```\nnpm i \u003cbinary file path\u003e/gp-powerbi-widget-1.0.0.tgz\n```\n\n  \n\n4. Import GpPowerbitWidgetModule in custom-widget.module.ts file located at /cumulocity-app-builder/custom-widgets/\n\n  \n\n```\nimport {GpPowerbiWidgetModule} from 'gp-powerbi-widget.module';\n@NgModule({\nimports: [\nGpPowerbiWidgetModule\n]\n})\n```\n\n  \n\n9. Congratulation! Installation is now completed. Now you can run app builder locally or build and deploy it into your tenant.\n\n  \n\n```\n//Start App Builder\nnpm run start\n\n// Build App \nnpm run build\n  \n// Deploy App\nnpm run deploy\n```\n\n  \n\n## Build Instructions\n\n  \n\n**Note:** It is only necessary to follow these instructions if you are modifying/extending this widget, otherwise see the [Installation Guide](#Installation).\n\n  \n\n**Requirements:**\n\n* Git\n\n  \n\n* NodeJS (release builds are currently built with `v14.15.0`)\n\n  \n\n* NPM (Included with NodeJS)\n\n  \n\n**Instructions**\n\n  \n  \n\n1. Clone the repository:\n\n  \n\n```\ngit clone https://github.com/SoftwareAG/cumulocity-powerbi-widget.git\n```\n\n  \n\n2. Change directory:\n\n  \n\n```\ncd cumulocity-powerbi-widget\n```\n\n  \n\n3. (Optional) Checkout a specific version:\n\n  \n\n```\ngit checkout \u003cyour version\u003e\n```\n\n  \n\n4. Install the dependencies:\n\n  \n\n```\nnpm install\n```\n\n  \n\n5. (Optional) Local development server:\n\n  \n\n```\nnpm run start\n```\n\n  \n\n6. Build the app:\n\n  \n\n```\nnpm run build\n```\n\n  \n\n7. Deploy the app:\n\n  \n\n```\nnpm run deploy\n```\n\n  \n\n## QuickStart\n\n  \n\nThis guide will teach you how to add widget in your existing or new dashboard.\n\n  \n\n  \n\n**NOTE:** This guide assumes you have followed the [Installation instructions](#Installation)\n\n  \n\n  \n\n1. Open you application from App Switcher\n\n  \n\n2. Add new dashboard or navigate to existing dashboard\n\n  \n\n3. Click `Add Widget`\n\n  \n\n4. Search for `Power BI`\n\n  \n  \n\n5. Select `Target API or Datahub`\n\n  \n  \n\n6. Fill Options required\n\n  \n\n7. Click `Save`\n\n  \n  \n\nCongratulations! Power BI is configured.\n\n  \n\n  \n\n## User Guide\n\n  \n\n  \n\n-  **DataHub URL :** User can specify DataHub URL if needed or use default.\n\n-  **PowerBI URL :** User can specify Power BI URL if needed or use default.\n-  **Embed URL :** User can specify Embed Report if needed(in case it has been updated on Power BI) or use default.\n\n-  **Load Workspace :** In case user changes DataHub or Power BI URL then they need to click this button to make a call to power BI and get the workspace and reports available if any. If the path is wrong, error will be shown.\n-  **Nav Pane :** To show Navigation Pane in Power BI Report or not. This comes from Power BI and is used if your workspace has more than one report in same page.\n-  **Filter Pane :** To show the Filter Pane in Power BI report or not. This comes from Power BI and can be used to see runtime changes in report based on filter applied.\n\n-  **Workspace :** Choose the workspace from dropdown list. Once selected, the reports dropdown is populated accordingly.\n\n-  **Report :** Choose the report from dropdown list.\n\n  \n\nNOTE : By default, first workspace and first report under that workspace comes selected.\n\n------------------------------\n\n  \n\nThis widget is 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.\n\n  \n\n_____________________\n\n  \n\nFor more information you can Ask a Question in the [TECHcommunity Forums](https://tech.forums.softwareag.com/tag/Cumulocity-IoT).\n\n  \n  \n\nYou can find additional information in the [Software AG TECHcommunity](https://techcommunity.softwareag.com/home/-/product/name/cumulocity).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSoftwareAG%2Fcumulocity-power-bi-widget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSoftwareAG%2Fcumulocity-power-bi-widget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSoftwareAG%2Fcumulocity-power-bi-widget/lists"}