power-bi 2.3.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c120eeef2ac35b02afcfff32690f003efad7fbfd59c7f2bd714a6d0659b1ed44
-  data.tar.gz: ee077e4fa8f6faae52ad5c1107fd96f9cb8bae5e7c8f0ef47a83009e7c80ce0d
+  metadata.gz: 90d415a89ed5860c82824f7e152e4c58d42054bc293f5534f6669774682a1ffe
+  data.tar.gz: 536d4c7cea48c859c7b780db751da15375b060a45c59946a2335887d8e948494
 SHA512:
-  metadata.gz: c9c742362808fb3fa08ad663ebbdaf34d916f932fa5bed8f66d657caf769c230a7694d82cd05555a642d41098ccb9fcf6eed9b6f89233ca344ff3f1c3d02b6fb
-  data.tar.gz: dc28a5e89d26365b7b48d5f6538bd1e8c12a9fe45c81b4f216ae63074ced3b728f31395c98751ee571a9e7234315693af5f6a7cffe4d86c398f6ec6683cfeafe
+  metadata.gz: d31db71feb4b03d7810d5805b3d48016e89ead1782bfae66269aa2a0c55340e6cf21031525ffa6d5b917cdc36041670ef52c1ccff499ebdfc7d0051d8005b6a8
+  data.tar.gz: 1ea49ae1a15e45b16c21b9da86c8ac20abb9e96a6eb63e6a0ed9a7dfcbca25dfff8431896703f2d55736a148668cf4b85ac591eb20c68bf1b2d9f6baee455e3a

data/README.md

@@ -62,7 +62,9 @@ Once authenticated, you can set profiles like this:
 pbi.profile = profile
 ```
 
-Every action executed after setting the profile, will be executed _through the eyes of the profile_.  This way, you can create an isolated multi-tenant setup.  Using profiles, simplifies the internal organization of Power BI and allows faster interaction with Power BI.  This also lifts the 1000-workspaces limit that is imposed on Master Userss and Service Principals
+Every action executed after setting the profile, will be executed _through the eyes of the profile_.  This way, you can create an isolated multi-tenant setup.  Using profiles, simplifies the internal organization of Power BI and allows faster interaction with Power BI.  This also lifts the 1000-workspaces limit that is imposed on Master Users and Service Principals
+
+Note: when working with Service principal profiles (SPP), you need to add the SPP to the gateway datasource before binding the gateway datasource to the dataset.
 
 # Supported endpoints
 
@@ -122,6 +124,11 @@ Note 2: to limit the number of API calls, it is best to directly use the _getter
 * Create a new gateway datasource: `gateway.gateway_datasource.create(name, credentials, db_server, db_name)`
 * Delete a new gateway datasource: `gateway_datasource.delete`
 
+## Gateway datasource users
+
+* List datasource users in a gateway datasource: `gateway_datasource.gateway_datasource_users`
+* Add a Service principal profile to a gateway datasource: `gateway_datasource.add_service_principal_profile_user(profile_id, principal_object_id)`
+
 ## Capacities
 
 Note: Capacities are Azure creatures, you can't create them in Power BI.

data/lib/power-bi/gateway.rb

@@ -8,7 +8,7 @@ module PowerBI
     end
 
     def get_data(id)
-      @tenant.get("/gateways/#{id}")
+      @tenant.get("/gateways/#{id}", use_profile: false)
     end
 
     def data_to_attributes(data)
@@ -32,7 +32,7 @@ module PowerBI
     end
 
     def get_data
-      @tenant.get("/gateways")[:value]
+      @tenant.get("/gateways", use_profile: false)[:value]
     end
   end
 end

data/lib/power-bi/gateway_datasource.rb

@@ -1,14 +1,15 @@
 module PowerBI
   class GatewayDatasource < Object
-    attr_reader :gateway
+    attr_reader :gateway, :gateway_datasource_users
 
     def initialize(tenant, parent, id = nil)
       super(tenant, id)
       @gateway = parent
+      @gateway_datasource_users = GatewayDatasourceUserArray.new(@tenant, self)
     end
 
     def get_data(id)
-      @tenant.get("/gateways/#{@gateway.id}/datasources/#{id}")
+      @tenant.get("/gateways/#{@gateway.id}/datasources/#{id}", use_profile: false)
     end
 
     def data_to_attributes(data)
@@ -24,7 +25,7 @@ module PowerBI
     end
 
     def update_credentials(encrypted_credentials)
-      @tenant.patch("/gateways/#{gateway.id}/datasources/#{id}") do |req|
+      @tenant.patch("/gateways/#{gateway.id}/datasources/#{id}", use_profile: false) do |req|
         req.body = {
           credentialDetails: {
             credentialType: "Basic",
@@ -41,7 +42,7 @@ module PowerBI
     end
 
     def delete
-      @tenant.delete("/gateways/#{gateway.id}/datasources/#{id}")
+      @tenant.delete("/gateways/#{gateway.id}/datasources/#{id}", use_profile: false)
       @gateway.gateway_datasources.reload
       true
     end
@@ -61,7 +62,7 @@ module PowerBI
 
     # only MySQL type is currently supported
     def create(name, encrypted_credentials, db_server, db_name)
-      data = @tenant.post("/gateways/#{@gateway.id}/datasources",) do |req|
+      data = @tenant.post("/gateways/#{@gateway.id}/datasources", use_profile: false) do |req|
         req.body = {
           connectionDetails: {server: db_server, database: db_name}.to_json,
           credentialDetails: {
@@ -82,7 +83,7 @@ module PowerBI
     end
 
     def get_data
-      @tenant.get("/gateways/#{@gateway.id}/datasources")[:value]
+      @tenant.get("/gateways/#{@gateway.id}/datasources", use_profile: false)[:value]
     end
   end
 end

data/lib/power-bi/gateway_datasource_user.rb

@@ -0,0 +1,51 @@
+module PowerBI
+  class GatewayDatasourceUser < Object
+    attr_reader :gateway_datasource
+
+    def initialize(tenant, parent, id = nil)
+      super(tenant, id)
+      @gateway_datasource = parent
+    end
+
+    def data_to_attributes(data)
+      {
+        datasource_access_right: data[:datasourceAccessRight],
+        display_name: data[:displayName],
+        email_address: data[:emailAddress],
+        identifier: data[:identifier],
+        principal_type: data[:principalType],
+        profile: data[:profile],
+      }
+    end
+
+  end
+
+  class GatewayDatasourceUserArray < Array
+
+    def initialize(tenant, gateway_datasource)
+      super(tenant, gateway_datasource)
+      @gateway_datasource = gateway_datasource
+    end
+
+    def self.get_class
+      GatewayDatasourceUser
+    end
+
+    # service principal object ID: https://learn.microsoft.com/en-us/power-bi/developer/embedded/embedded-troubleshoot#what-is-the-difference-between-application-object-id-and-principal-object-id
+    def add_service_principal_profile_user(profile_id, principal_object_id, datasource_access_right: "Read")
+      @tenant.post("/gateways/#{@gateway_datasource.gateway.id}/datasources/#{@gateway_datasource.id}/users", use_profile: false) do |req|
+        req.body = {
+          datasourceAccessRight: datasource_access_right,
+          identifier: principal_object_id,
+          principalType: "App",
+          profile: {id: profile_id},
+        }.to_json
+      end
+      self.reload
+    end
+
+    def get_data
+      @tenant.get("/gateways/#{@gateway_datasource.gateway.id}/datasources/#{@gateway_datasource.id}/users", use_profile: false)[:value]
+    end
+  end
+end

data/lib/power-bi/profile.rb

@@ -6,7 +6,7 @@ module PowerBI
     end
 
     def get_data(id)
-      @tenant.get("/profiles/#{id}")
+      @tenant.get("/profiles/#{id}", use_profile: false)
     end
 
     def data_to_attributes(data)
@@ -17,7 +17,7 @@ module PowerBI
     end
 
     def delete
-      @tenant.delete("/profiles/#{@id}")
+      @tenant.delete("/profiles/#{@id}", use_profile: false)
       @tenant.profiles.reload
       true
     end
@@ -30,7 +30,7 @@ module PowerBI
     end
 
     def create(name)
-      data = @tenant.post("/profiles") do |req|
+      data = @tenant.post("/profiles", use_profile: false) do |req|
         req.body = {displayName: name}.to_json
       end
       self.reload
@@ -38,7 +38,7 @@ module PowerBI
     end
 
     def get_data
-      @tenant.get("/profiles")[:value]
+      @tenant.get("/profiles", use_profile: false)[:value]
     end
   end
 end

data/lib/power-bi/tenant.rb

@@ -1,6 +1,6 @@
 module PowerBI
   class Tenant
-    attr_reader :workspaces, :gateways, :capacities, :profiles, :profile
+    attr_reader :workspaces, :gateways, :capacities, :profiles, :profile_id
 
     def initialize(token_generator, retries: 5, logger: nil)
       @token_generator = token_generator
@@ -9,7 +9,7 @@ module PowerBI
       @capacities = CapacityArray.new(self)
       @profiles = ProfileArray.new(self)
       @logger = logger
-      @profile = nil
+      @profile_id = nil
 
       ## WHY RETRIES? ##
       # It is noticed that once in a while (~0.1% API calls), the Power BI server returns a 500 (internal server error) without apparent reason, just retrying works :-)
@@ -44,12 +44,16 @@ module PowerBI
       Capacity.new(self, nil, id)
     end
 
+    def profile(id)
+      Profile.new(self, nil, id)
+    end
+
     def profile=(profile)
-      @profile = profile
+      @profile_id = profile.is_a?(String) ? profile : profile&.id
       @workspaces.reload # we need to reload the workspaces because we look through the eyes of the profile
     end
 
-    def get(url, params = {})
+    def get(url, params = {}, use_profile: true)
       t0 = Time.now
       conn = Faraday.new do |f|
         f.request :retry, @retry_options
@@ -58,8 +62,8 @@ module PowerBI
         req.params = params
         req.headers['Accept'] = 'application/json'
         req.headers['authorization'] = "Bearer #{token}"
-        if @profile
-          req.headers['X-PowerBI-Profile-Id'] = @profile.id
+        if use_profile
+          add_spp_header(req)
         end
         yield req if block_given?
       end
@@ -75,7 +79,7 @@ module PowerBI
       end
     end
 
-    def get_raw(url, params = {})
+    def get_raw(url, params = {}, use_profile: true)
       t0 = Time.now
       conn = Faraday.new do |f|
         f.request :retry, @retry_options
@@ -83,8 +87,8 @@ module PowerBI
       response = conn.get(PowerBI::BASE_URL + url) do |req|
         req.params = params
         req.headers['authorization'] = "Bearer #{token}"
-        if @profile
-          req.headers['X-PowerBI-Profile-Id'] = @profile.id
+        if use_profile
+          add_spp_header(req)
         end
         yield req if block_given?
       end
@@ -95,7 +99,7 @@ module PowerBI
       response.body
     end
 
-    def post(url, params = {})
+    def post(url, params = {}, use_profile: true)
       t0 = Time.now
       conn = Faraday.new do |f|
         f.request :retry, @retry_options
@@ -105,8 +109,8 @@ module PowerBI
         req.headers['Accept'] = 'application/json'
         req.headers['Content-Type'] = 'application/json'
         req.headers['authorization'] = "Bearer #{token}"
-        if @profile
-          req.headers['X-PowerBI-Profile-Id'] = @profile.id
+        if use_profile
+          add_spp_header(req)
         end
         yield req if block_given?
       end
@@ -119,7 +123,7 @@ module PowerBI
       end
     end
 
-    def patch(url, params = {})
+    def patch(url, params = {}, use_profile: true)
       t0 = Time.now
       conn = Faraday.new do |f|
         f.request :retry, @retry_options
@@ -129,8 +133,8 @@ module PowerBI
         req.headers['Accept'] = 'application/json'
         req.headers['Content-Type'] = 'application/json'
         req.headers['authorization'] = "Bearer #{token}"
-        if @profile
-          req.headers['X-PowerBI-Profile-Id'] = @profile.id
+        if use_profile
+          add_spp_header(req)
         end
         yield req if block_given?
       end
@@ -143,7 +147,7 @@ module PowerBI
       end
     end
 
-    def delete(url, params = {})
+    def delete(url, params = {}, use_profile: true)
       t0 = Time.now
       conn = Faraday.new do |f|
         f.request :retry, @retry_options
@@ -152,8 +156,8 @@ module PowerBI
         req.params = params
         req.headers['Accept'] = 'application/json'
         req.headers['authorization'] = "Bearer #{token}"
-        if @profile
-          req.headers['X-PowerBI-Profile-Id'] = @profile.id
+        if use_profile
+          add_spp_header(req)
         end
         yield req if block_given?
       end
@@ -169,7 +173,7 @@ module PowerBI
       end
     end
 
-    def post_file(url, file, params = {})
+    def post_file(url, file, params = {}, use_profile: true)
       t0 = Time.now
       conn = Faraday.new do |f|
         f.request :multipart
@@ -180,8 +184,8 @@ module PowerBI
         req.headers['Accept'] = 'application/json'
         req.headers['Content-Type'] = 'multipart/form-data'
         req.headers['authorization'] = "Bearer #{token}"
-        if @profile
-          req.headers['X-PowerBI-Profile-Id'] = @profile.id
+        if use_profile
+          add_spp_header(req)
         end
         req.body = {value: Faraday::UploadIO.new(file, 'application/octet-stream')}
         req.options.timeout = 120  # default is 60 seconds Net::ReadTimeout
@@ -195,6 +199,12 @@ module PowerBI
 
     private
 
+    def add_spp_header(req)
+      if @profile_id
+        req.headers['X-PowerBI-Profile-Id'] = @profile_id
+      end
+    end
+
     def token
       @token_generator.call
     end

data/lib/power-bi.rb

@@ -22,6 +22,7 @@ require_relative "power-bi/parameter"
 require_relative "power-bi/refresh"
 require_relative "power-bi/gateway"
 require_relative "power-bi/gateway_datasource"
+require_relative "power-bi/gateway_datasource_user"
 require_relative "power-bi/page"
 require_relative "power-bi/user"
 require_relative "power-bi/capacity"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: power-bi
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 2.4.0
 platform: ruby
 authors:
 - Lode Cools
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-04 00:00:00.000000000 Z
+date: 2024-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -95,6 +95,7 @@ files:
 - lib/power-bi/datasource.rb
 - lib/power-bi/gateway.rb
 - lib/power-bi/gateway_datasource.rb
+- lib/power-bi/gateway_datasource_user.rb
 - lib/power-bi/object.rb
 - lib/power-bi/page.rb
 - lib/power-bi/parameter.rb