From 74ab91be3b562214463b7802262d2117ab1fe647 Mon Sep 17 00:00:00 2001 From: Iain Sproat <68657+iainsproat@users.noreply.github.com> Date: Thu, 8 Aug 2024 14:39:07 +0100 Subject: [PATCH 1/3] chore(domains): update speckle.xyz to app.speckle.systems (#77) - remove reference to DO 1-click as this is deprecated --- README.md | 3 +-- src/powerbi-data-connector/tests/api/api.fetch.test.pq | 2 +- .../tests/api/api.rest.getobject.test.pq | 2 +- src/powerbi-data-connector/tests/get.byurl.test.pq | 2 +- src/powerbi-data-connector/tests/getbyurl.test.pq | 2 +- src/powerbi-visual/capabilities.json | 2 ++ 6 files changed, 7 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 5ff818f..8ca8547 100644 --- a/README.md +++ b/README.md @@ -31,8 +31,7 @@ What is Speckle? Check our ![YouTube Video Views](https://img.shields.io/youtube Give Speckle a try in no time by: -- [![speckle XYZ](https://img.shields.io/badge/https://-speckle.xyz-0069ff?style=flat-square&logo=hackthebox&logoColor=white)](https://speckle.xyz) ⇒ creating an account at our public server -- [![create a droplet](https://img.shields.io/badge/Create%20a%20Droplet-0069ff?style=flat-square&logo=digitalocean&logoColor=white)](https://marketplace.digitalocean.com/apps/speckle-server?refcode=947a2b5d7dc1) ⇒ deploying an instance in 1 click +- [![app.speckle.systems](https://img.shields.io/badge/https://-speckle.xyz-0069ff?style=flat-square&logo=hackthebox&logoColor=white)](https://app.speckle.systems) ⇒ creating an account at our public server ### Resources diff --git a/src/powerbi-data-connector/tests/api/api.fetch.test.pq b/src/powerbi-data-connector/tests/api/api.fetch.test.pq index 8927657..d8ed518 100644 --- a/src/powerbi-data-connector/tests/api/api.fetch.test.pq +++ b/src/powerbi-data-connector/tests/api/api.fetch.test.pq @@ -1,2 +1,2 @@ // Use this file to write queries to test your data connector -let result = Speckle.Api.Fetch("https://latest.speckle.dev") in Record.ToTable(result) \ No newline at end of file +let result = Speckle.Api.Fetch("https://latest.speckle.systems") in Record.ToTable(result) \ No newline at end of file diff --git a/src/powerbi-data-connector/tests/api/api.rest.getobject.test.pq b/src/powerbi-data-connector/tests/api/api.rest.getobject.test.pq index e1e72ec..fb055ca 100644 --- a/src/powerbi-data-connector/tests/api/api.rest.getobject.test.pq +++ b/src/powerbi-data-connector/tests/api/api.rest.getobject.test.pq @@ -1,7 +1,7 @@ // Use this file to write queries to test your data connector let result = Speckle.Api.REST.GetObject( - "https://latest.speckle.dev", "5f284e5c70", "85e5f250fe591ea74d8d5dc1137a9341" + "https://latest.speckle.systems", "5f284e5c70", "85e5f250fe591ea74d8d5dc1137a9341" ) in result diff --git a/src/powerbi-data-connector/tests/get.byurl.test.pq b/src/powerbi-data-connector/tests/get.byurl.test.pq index 6bdd978..d0599c2 100644 --- a/src/powerbi-data-connector/tests/get.byurl.test.pq +++ b/src/powerbi-data-connector/tests/get.byurl.test.pq @@ -1,2 +1,2 @@ // Use this file to write queries to test your data connector -let result = Speckle.Get.ByUrl("https://latest.speckle.dev/streams/3d25474a18") in Record.ToTable(result) +let result = Speckle.Get.ByUrl("https://latest.speckle.systems/streams/3d25474a18") in Record.ToTable(result) diff --git a/src/powerbi-data-connector/tests/getbyurl.test.pq b/src/powerbi-data-connector/tests/getbyurl.test.pq index 8ab6148..181a52a 100644 --- a/src/powerbi-data-connector/tests/getbyurl.test.pq +++ b/src/powerbi-data-connector/tests/getbyurl.test.pq @@ -1,2 +1,2 @@ // Use this file to write queries to test your data connector -let result = Speckle.GetByUrl("https://latest.speckle.dev/streams/5f284e5c70/objects/85e5f250fe591ea74d8d5dc1137a9341") in result +let result = Speckle.GetByUrl("https://latest.speckle.systems/streams/5f284e5c70/objects/85e5f250fe591ea74d8d5dc1137a9341") in result diff --git a/src/powerbi-visual/capabilities.json b/src/powerbi-visual/capabilities.json index d38345a..b808ca7 100644 --- a/src/powerbi-visual/capabilities.json +++ b/src/powerbi-visual/capabilities.json @@ -206,8 +206,10 @@ "essential": true, "name": "WebAccess", "parameters": [ + "https://app.speckle.systems", "https://speckle.xyz", "https://*.speckle.xyz", + "https://latest.speckle.systems", "https://latest.speckle.dev", "https://*.speckle.dev", "https://analytics.speckle.systems", From b26801ef8a871d8f22bf062c6e78df1e8255f5e4 Mon Sep 17 00:00:00 2001 From: Mucahit Bilal GOKER <51519350+bimgeek@users.noreply.github.com> Date: Thu, 8 Aug 2024 16:40:35 +0300 Subject: [PATCH 2/3] Update README.md (#76) --- README.md | 108 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 56 insertions(+), 52 deletions(-) diff --git a/README.md b/README.md index 5ff818f..5bde500 100644 --- a/README.md +++ b/README.md @@ -1,96 +1,100 @@


- Speckle | PowerBI + Speckle | Power BI

- Data Connector and 3D Viewer Visual for PowerBI platform + Data Connector and 3D Viewer Visual for Power BI platform

Speckle is the data infrastructure for the AEC industry.


Twitter Follow Community forum users website docs

-# About Speckle +Speckle Power BI Data Connector lets you easily get data from Speckle into Power BI reports and visualizations. You can access and analyze data from various AEC apps (like Revit, Archicad, Grasshopper, and more) and open-source files (IFC, STL, OBJ, etc.) into Power BI with ease. -What is Speckle? Check our ![YouTube Video Views](https://img.shields.io/youtube/views/B9humiSpHzM?label=Speckle%20in%201%20minute%20video&style=social) +Speckle’s connection to Power BI consists of two parts: -### Features +- **Data Connector** fetches the data you uploaded from AEC apps to Speckle. +- **3D Visual** allows you to see those models in 3D within Power BI. -- **Object-based:** say goodbye to files! Speckle is the first object based platform for the AEC industry -- **Version control:** Speckle is the Git & Hub for geometry and BIM data -- **Collaboration:** share your designs collaborate with others -- **3D Viewer:** see your CAD and BIM models online, share and embed them anywhere -- **Interoperability:** get your CAD and BIM models into other software without exporting or importing -- **Real time:** get real time updates and notifications and changes -- **GraphQL API:** get what you need anywhere you want it -- **Webhooks:** the base for a automation and next-gen pipelines -- **Built for developers:** we are building Speckle with developers in mind and got tools for every stack -- **Built for the AEC industry:** Speckle connectors are plugins for the most common software used in the industry such as Revit, Rhino, Grasshopper, AutoCAD, Civil 3D, Excel, Unreal Engine, Unity, QGIS, Blender and more! +![Desktop - 1 (1)](https://github.com/specklesystems/speckle-powerbi/assets/51519350/6d2c5224-965f-4eae-b869-be26cb48c6b2) -### Try Speckle now! +# Repo Structure -Give Speckle a try in no time by: +This repo is home to our Power BI connector. The Speckle Server provides all the web-facing functionality and can be found [here](https://github.com/specklesystems/Server). -- [![speckle XYZ](https://img.shields.io/badge/https://-speckle.xyz-0069ff?style=flat-square&logo=hackthebox&logoColor=white)](https://speckle.xyz) ⇒ creating an account at our public server -- [![create a droplet](https://img.shields.io/badge/Create%20a%20Droplet-0069ff?style=flat-square&logo=digitalocean&logoColor=white)](https://marketplace.digitalocean.com/apps/speckle-server?refcode=947a2b5d7dc1) ⇒ deploying an instance in 1 click +`src/powerbi-data-connector` contains all the code for the Data connector. -### Resources +`src/powerbi-visual` contains all the code for 3D Visual. -- [![Community forum users](https://img.shields.io/badge/community-forum-green?style=for-the-badge&logo=discourse&logoColor=white)](https://speckle.community) for help, feature requests or just to hang with other speckle enthusiasts, check out our community forum! -- [![website](https://img.shields.io/badge/tutorials-speckle.systems-royalblue?style=for-the-badge&logo=youtube)](https://speckle.systems) our tutorials portal is full of resources to get you started using Speckle -- [![docs](https://img.shields.io/badge/docs-speckle.guide-orange?style=for-the-badge&logo=read-the-docs&logoColor=white)](https://speckle.guide/dev/) reference on almost any end-user and developer functionality +# Installation -![Untitled](https://user-images.githubusercontent.com/2679513/132021739-15140299-624d-4410-98dc-b6ae6d9027ab.png) +Speckle connector can be installed directly from [Manager for Speckle](https://speckle.systems/download/). Full instructions for [installation](https://speckle.guide/user/powerbi/installation.html) and [configuration](https://speckle.guide/user/powerbi/configuration.html) can be found on our docs. -# Repo structure +# Using 3D Visual -This repo is the home to our Speckle 2.0 PowerBI project. The [Speckle Server](https://github.com/specklesystems/Server) is providing all the web-facing functionality and can be found [here](https://github.com/specklesystems/Server). +3D Visual can be imported as any other Power BI custom visual. -## Install +1. Navigate to the Visualization Pane. +2. Click the three dots (…) and select “Import a visual from a file”. +3. Go to `Documents/Power BI Desktop/Custom Visuals` and import `Speckle 3D Visual.pbiviz` file. +4. Speckle cube will appear in the Visualization pane. -Go to the [Releases](https://github.com/specklesystems/speckle-powerbi/releases) page, downlad the `.mez` file of the latest release and copy it into the following folder in your computer: +For more on how to use the visual, [check our docs](https://speckle.guide/user/powerbi-visual/introduction.html). -``` -YOUR_USER_FOLDER\Documents\Power BI Desktop\Custom Connectors\ -``` -If the folder doesn't exist, create it. +# Usage -### Allow custom extensions to run +To get started with Power BI connectors, please take a look at the [documentation](https://speckle.guide/user/powerbi/introduction.html) and extensive [tutorials](https://www.youtube.com/playlist?list=PLlI5Dyt2HaEsZHG2WJ75WIM0Brx6VHT2S) published. -Go to `Settings -> Security -> Data Extensions` and activate the following option: +# **Developing & Debugging** -![Allow extensions to run](https://user-images.githubusercontent.com/2316535/130931149-074cf6a8-1910-41f1-99c7-b8b08168f473.png) +We encourage everyone interested to debug/hack/contribute/give feedback to this project. -### Checking the connector is loaded +## **Setup** -Now open PowerBI and you should see `Speckle (beta)` appear in the data source. +### **Install PowerQuery SDK** -![PowerBI](https://user-images.githubusercontent.com/2316535/129580913-02e5e662-f344-419c-9894-e97055930c58.png) +Follow the instructions from the [official docs](https://docs.microsoft.com/en-us/power-query/installingsdk) -## Usage +### **Build with Visual Studio** -> More detailed instructions on how to use the connector will be added shortly! +Every time you build the connector, VisualStudio will copy the latest `.mez` connector file to the appropriate location. Just restart PowerBI to see the latest changes. + +### **Debug** + +You can start the PowerQuery connector in VisualStudio, this will open a standalone connector you can use for testing purposes. -### Current limitations +We don't know of a way to debug the connector live in PowerBI, but we'd be happy to hear about it. -Chunked data currently is not automatically de-chunked when received, we are aware of this limitation and are working to resolve it! -## Developing & Debugging +# About Speckle -We encourage everyone interested to debug / hack / contribute / give feedback to this project. +What is Speckle? Check our ![YouTube Video Views](https://img.shields.io/youtube/views/B9humiSpHzM?label=Speckle%20in%201%20minute%20video&style=social) -### Setup +### Features -#### Install PowerQuery SDK +- **Object-based:** say goodbye to files! Speckle is the first object based platform for the AEC industry +- **Version control:** Speckle is the Git & Hub for geometry and BIM data +- **Collaboration:** share your designs collaborate with others +- **3D Viewer:** see your CAD and BIM models online, share and embed them anywhere +- **Interoperability:** get your CAD and BIM models into other software without exporting or importing +- **Real time:** get real time updates and notifications and changes +- **GraphQL API:** get what you need anywhere you want it +- **Webhooks:** the base for a automation and next-gen pipelines +- **Built for developers:** we are building Speckle with developers in mind and got tools for every stack +- **Built for the AEC industry:** Speckle connectors are plugins for the most common software used in the industry such as Revit, Rhino, Grasshopper, AutoCAD, Civil 3D, Excel, Unreal Engine, Unity, QGIS, Blender and more! -Follow the instructions from the [official docs](https://docs.microsoft.com/en-us/power-query/installingsdk) +### Try Speckle now! -#### Build with Visual Studio +Give Speckle a try in no time by: -Every time you build the connector, VisualStudio will copy the latest `.mez` connector file to the appropriate location. Just restart PowerBI to see the latest changes. +- [![speckle XYZ](https://img.shields.io/badge/https://-speckle.xyz-0069ff?style=flat-square&logo=hackthebox&logoColor=white)](https://speckle.xyz) ⇒ creating an account at our public server +- [![create a droplet](https://img.shields.io/badge/Create%20a%20Droplet-0069ff?style=flat-square&logo=digitalocean&logoColor=white)](https://marketplace.digitalocean.com/apps/speckle-server?refcode=947a2b5d7dc1) ⇒ deploying an instance in 1 click -#### Debug +### Resources -You can start the PowerQuery connector in VisualStudio, this will open a standalone connector you can use for testing purposes. +- [![Community forum users](https://img.shields.io/badge/community-forum-green?style=for-the-badge&logo=discourse&logoColor=white)](https://speckle.community) for help, feature requests or just to hang with other speckle enthusiasts, check out our community forum! +- [![website](https://img.shields.io/badge/tutorials-speckle.systems-royalblue?style=for-the-badge&logo=youtube)](https://speckle.systems) our tutorials portal is full of resources to get you started using Speckle +- [![docs](https://img.shields.io/badge/docs-speckle.guide-orange?style=for-the-badge&logo=read-the-docs&logoColor=white)](https://speckle.guide/dev/) reference on almost any end-user and developer functionality -We don't know of a way to debug the connector live in PowerBI, but we'd be happy to hear about it. +![Untitled](https://user-images.githubusercontent.com/2679513/132021739-15140299-624d-4410-98dc-b6ae6d9027ab.png) From 556196a45ff60e79b0c4ae327c2dc8367e68f4d8 Mon Sep 17 00:00:00 2001 From: Mucahit Bilal GOKER <51519350+bimgeek@users.noreply.github.com> Date: Thu, 5 Sep 2024 16:38:02 +0300 Subject: [PATCH 3/3] fixed extension path (#79) --- speckle-powerbi.code-workspace | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/speckle-powerbi.code-workspace b/speckle-powerbi.code-workspace index 1c7691e..70bdecb 100644 --- a/speckle-powerbi.code-workspace +++ b/speckle-powerbi.code-workspace @@ -16,7 +16,7 @@ "settings": { "powerquery.general.mode": "SDK", "powerquery.sdk.defaultQueryFile": "${workspaceFolder}\\src\\powerbi-data-connector\\Speckle.query.pq", - "powerquery.sdk.defaultExtension": "${workspaceFolder}\\bin\\${workspaceFolderBasename}.mez", + "powerquery.sdk.defaultExtension": "${workspaceFolder}\\src\\powerbi-data-connector\\bin\\Speckle.mez", "files.eol": "\n", "files.watcherExclude": { "**/.git/objects/**": true,