tableau_server_client 0.0.19 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9ece5e128410a403cebb77343a1efecfcaa11af7943e63e0f5cd4742a7b86e8
-  data.tar.gz: 26692e9b42d023e71498afaa938daf96886af823eb24100bb48a790e34369830
+  metadata.gz: a2b753dc351bba7fa961e4772449b2ef68789fd24f6ca632983f506c729d596e
+  data.tar.gz: a6de27794f5a2fcf43f393f4f259cda8250860c30176852b586d458d87e2e60b
 SHA512:
-  metadata.gz: 15ce18273d3ef76cb0db3978ad7c246520e22e114c53a72f7d08d9502d6422217fd52ddafc2649d2503c4a1184e731f620505a58e6e4575d98643691b3276ea0
-  data.tar.gz: 0ea42f4fe5dfcaac59a08e7ceb5b24e5ae4f9959f588d4b05b7cca0b52eab52dda5ebc7b0329d9d9f2f434990fad3b5e7604e4097a7b95673c0759eb5ddd3562
+  metadata.gz: cc52e212245271db396f36989401102e78377e5b794977e580d17d65394033bd36398dcf50249a96c7f595ef4cbc07f447dcf92d7a28c090d19264a2019d98f3
+  data.tar.gz: 5f4a6ea560350dcc8641b9ad1c8b04187d8973d14ac5679546ec66f595e7decc65aafda880b2021aca962c2d88b265950b58e14defb7012c31aed802bcc53eb8

data/lib/tableau_server_client/client.rb

@@ -14,17 +14,18 @@ module TableauServerClient
   class Client
     include RequestBuilder
 
-    def initialize(server_url, username, password, site_name, api_version, token_lifetime, logger)
+    def initialize(server_url, username, password, content_url, api_version, token_lifetime, logger, impersonation_user_id)
       @server_url = server_url
       @username = username
       @password = password
-      @site_name = site_name
+      @content_url = content_url
       @api_version = api_version
       @token_lifetime = token_lifetime
       @logger = logger
+      @impersonation_user_id = impersonation_user_id
     end
 
-    attr_reader :site_name, :username, :api_version, :token_lifetime, :logger
+    attr_reader :content_url, :username, :api_version, :token_lifetime, :logger, :impersonation_user_id
 
     def server_url
       @_server_url ||= URI(@server_url.chomp("/"))
@@ -65,15 +66,27 @@ module TableauServerClient
       return response
     end
 
-    def update(resource)
+    def download_image(resource_location, file_path: nil)
+      req_url = request_url("#{resource_location.path}/image", resource_location.query_params)
+      response = session.get req_url.to_s
+      if file_path
+        File.write(file_path, response.body)
+      end
+      return response.body
+    end
+
+    def update(resource, path: nil, request: nil)
+      path = path || resource.path
+      request = request || resource.to_request
       session.put do |req|
-        req.url request_url(resource.path).to_s
-        req.body = resource.to_request
+        req.url request_url(path).to_s
+        req.body = request
       end
     end
 
-    def delete(resource)
-      session.delete request_url(resource.path).to_s
+    def delete(resource, path: nil)
+      path = path || resource.path
+      session.delete request_url(path).to_s
     end
 
     def session
@@ -104,6 +117,7 @@ module TableauServerClient
       request = request_body {|b|
         b.credentials(name: username, password: password) {
           b.site(contentUrl: content_url)
+          b.user(id: impersonation_user_id) if impersonation_user_id
         }
       }
       # POST without Token
@@ -114,10 +128,6 @@ module TableauServerClient
       @token = TableauServerClient::Token.parse(res.body, token_lifetime)
     end
 
-    def content_url
-      site_name == 'default' ? "" : site_name
-    end
-
     def faraday
       @faraday ||= Faraday.new(request: {params_encoder: EmptyEncoder.new}, headers: {'Content-Type' => 'application/xml'}) do |f|
         f.response :raise_error

data/lib/tableau_server_client/exception.rb

@@ -0,0 +1,5 @@
+module TableauServerClient
+
+  class TableauServerClientError < StandardError; end
+
+end

data/lib/tableau_server_client/resources/extract_refresh.rb

@@ -58,6 +58,10 @@ module TableauServerClient
         Job.from_response(@client, Job.location(site_path, id = job_id).path, resp)
       end
 
+      def delete!
+        resp = @client.delete(self)
+      end
+
     end
   end
 end

data/lib/tableau_server_client/resources/group.rb

@@ -0,0 +1,31 @@
+require 'tableau_server_client/resources/resource'
+
+module TableauServerClient
+  module Resources
+
+    class Group < Resource
+
+      attr_reader :id, :name, :site_role
+
+      def self.from_response(client, path, xml)
+        attrs = extract_attributes(xml)
+        if xml.xpath("xmlns:import")[0]
+          attrs['site_role'] = xml.xpath("xmlns:import")[0]['siteRole']
+        end
+        new(client, path, attrs)
+      end
+
+      def self.from_collection_response(client, path, xml)
+        xml.xpath("//xmlns:groups/xmlns:group").each do |s|
+          id = s['id']
+          yield from_response(client, "#{path}/#{id}", s)
+        end
+      end
+
+      def users
+        @client.get_collection(User.location(path))
+      end
+
+    end
+  end
+end

data/lib/tableau_server_client/resources/project.rb

@@ -1,4 +1,5 @@
 require 'tableau_server_client/resources/resource'
+require 'tableau_server_client/resources/workbook'
 
 module TableauServerClient
   module Resources
@@ -59,6 +60,12 @@ module TableauServerClient
         @hierarchy ||= (parent_projects << self).map {|p| p.name }.join('/')
       end
 
+      def workbooks
+        @client.get_collection(Workbook.location(site_path, filter: [])).select {|w|
+          w.project_id == id
+        }
+      end
+
       def extract_values_in_description
         @values_in_description ||=\
           description.lines.map { |l|/^(.*):\s*(.*)$/.match(l) }.reject { |m| m.nil? }.map { |m| m[1,2] }.to_h

data/lib/tableau_server_client/resources/resource.rb

@@ -61,6 +61,14 @@ module TableauServerClient
         self.class.extract_site_path(path)
       end
 
+      def site_id
+        site_path.split('/')[1]
+      end
+
+      def server_url
+        @client.server_url
+      end
+
       def delete!
         @client.delete self
       end

data/lib/tableau_server_client/resources/site.rb

@@ -4,6 +4,8 @@ require 'tableau_server_client/resources/workbook'
 require 'tableau_server_client/resources/user'
 require 'tableau_server_client/resources/subscription'
 require 'tableau_server_client/resources/extract_refresh'
+require 'tableau_server_client/resources/view'
+require 'tableau_server_client/resources/group'
 
 module TableauServerClient
   module Resources
@@ -40,6 +42,14 @@ module TableauServerClient
         @client.get Workbook.location(path, id)
       end
 
+      def views(filter: [])
+        @client.get_collection View.location(path, filter: filter)
+      end
+
+      def view(id)
+        @client.get View.location(path, id)
+      end
+
       def users(filter: [])
         @client.get_collection User.location(path, filter: filter)
       end
@@ -68,6 +78,11 @@ module TableauServerClient
         @client.get_collection ExtractRefresh.location("#{path}/tasks")
       end
 
+      def groups(filter: [])
+        @client.get_collection Group.location(path, filter: filter)
+      end
+
+
     end
   end
 end

data/lib/tableau_server_client/resources/user.rb

@@ -20,7 +20,7 @@ module TableauServerClient
       end
 
       def reload
-        @client.get User.location(site_path, id)
+        @client.get location
       end
 
       def full_name
@@ -39,6 +39,23 @@ module TableauServerClient
         end
       end
 
+      def to_request
+        request = build_request {|b|
+          b.user(siteRole: site_role)
+        }
+      end
+
+      def update_site_role!(role)
+        @site_role = role
+        # Using location to get corretct path
+        # When initialized from Group path will be groups/group_id/users/user_id
+        @client.update(self, path: location.path)
+      end
+
+      def location
+        User.location(site_path, id)
+      end
+
     end
   end
 end

data/lib/tableau_server_client/resources/view.rb

@@ -0,0 +1,45 @@
+require 'tableau_server_client/resources/resource'
+require 'tableau_server_client/resources/workbook'
+
+module TableauServerClient
+  module Resources
+
+    class View < Resource
+
+      attr_reader :id, :name, :content_url, :workbook_id
+      attr_writer :owner
+
+      def self.from_response(client, path, xml)
+        attrs = extract_attributes(xml)
+        attrs['workbook_id'] = xml.xpath("xmlns:workbook")[0]['id']
+        new(client, path, attrs)
+      end
+
+      def self.from_collection_response(client, path, xml)
+        xml.xpath("//xmlns:views/xmlns:view").each do |s|
+          id = s['id']
+          yield from_response(client, "#{path}/#{id}", s)
+        end
+      end
+
+      def workbook
+        client.get Workbook.location(site_path, workbook_id)
+      end
+
+      def webpage_url
+        "#{server_url}#{content}/#/views/#{webpage_path}"
+      end
+
+      def webpage_path
+        content_url.gsub('/sheets/', '/')
+      end
+
+      def image(query_params: {}, file_path: nil)
+        return @image if @iamge
+        @image = client.download_image(location(query_params: query_params), file_path: file_path)
+        @image
+      end
+
+    end
+  end
+end

data/lib/tableau_server_client/resources/workbook.rb

@@ -3,6 +3,7 @@ require 'tableau_server_client/resources/project'
 require 'tableau_server_client/resources/connection'
 require 'tableau_server_client/resources/downloadable'
 require 'tableau_server_client/resources/datasource'
+require 'tableau_server_client/resources/view'
 
 module TableauServerClient
   module Resources
@@ -10,13 +11,14 @@ module TableauServerClient
     class Workbook < Resource
       include Downloadable
 
-      attr_reader :id, :name, :webpage_url, :content_url, :show_tabs, :size, :created_at, :updated_at
+      attr_reader :id, :name, :webpage_url, :content_url, :show_tabs, :size, :created_at, :updated_at, :project_id, :owner_id, :tags
       attr_writer :owner
 
       def self.from_response(client, path, xml)
         attrs = extract_attributes(xml)
         attrs['project_id'] = xml.xpath("xmlns:project")[0]['id']
-        attrs['owner_id']   = xml.xpath("xmlns:owner")[0]['id']
+        attrs['owner_id'] = xml.xpath("xmlns:owner")[0]['id']
+        attrs['tags'] = xml.xpath("xmlns:tags/xmlns:tag").map {|t| t['label'] }
         new(client, path, attrs)
       end
 
@@ -32,13 +34,17 @@ module TableauServerClient
       end
 
       def project
-        @project ||= @client.get_collection(Project.location(site_path)).find {|p| p.id == @project_id }
+        @project ||= @client.get_collection(Project.location(site_path)).find {|p| p.id == project_id }
       end
 
       def owner
         @owner ||= @client.get User.location(site_path, @owner_id)
       end
 
+      def views
+        @views ||= @client.get_collection(View.location(site_path)).select {|v| v.workbook_id == id }
+      end
+
       def to_request
         request = build_request {|b|
           b.workbook {|w|
@@ -52,6 +58,21 @@ module TableauServerClient
         @client.update self
       end
 
+      def add_tags!(tags)
+        request = build_request {|b|
+          b.tags {
+            tags.each do |t|
+              b.tag(label: t)
+            end
+          }
+        }
+        resp = @client.update(self, path: "#{path}/tags", request: request)
+      end
+
+      def delete_tag!(tag)
+        @client.delete(self, path: "#{path}/tags/#{tag}")
+      end
+
       def embedded_datasources
         download.xpath('//datasources//datasource').map do |ds|
           Datasource::DatasourceContent.new(ds)

data/lib/tableau_server_client/server.rb

@@ -1,25 +1,47 @@
 require 'tableau_server_client/client'
 require 'tableau_server_client/resources/site'
 require 'tableau_server_client/resources/schedule'
+require 'tableau_server_client/exception'
 require 'logger'
 
 module TableauServerClient
   class Server
 
+    #Implement for_token
+    #def for_token(token)
+
     def initialize(server_url, username, password,
-                   site_name: "default", api_version: "3.1", token_lifetime: 240,
-                   log_level: :info)
+                   content_url: "", api_version: "3.1", token_lifetime: 240,
+                   log_level: :info, impersonation_username: nil)
+      @server_url = server_url
+      @username = username
+      @password = password
+      @content_url = content_url
+      @api_version = api_version
+      @token_lifetime = token_lifetime
       @logger = ::Logger.new(STDOUT)
       @logger.level = ::Logger.const_get(log_level.upcase.to_sym)
-      @client = Client.new(server_url, username, password, site_name, api_version, token_lifetime, @logger)
+      @impersonation_username = impersonation_username
     end
 
+    attr_reader :server_url, :username, :content_url, :api_version, :token_lifetime, :logger, :impersonation_username
+
     def sites
-      client.get_collection Resources::Site.location(path)
+      client.get_collection(Resources::Site.location(path)).map {|s|
+        client_for_site(s.content_url).get_collection(Resources::Site.location(path)).select {|x| x.id == s.id }.first
+      }
     end
 
     def site(id)
-      client.get Resources::Site.location(path, id)
+      sites.select { |s| s.id == id }.first
+    end
+
+    def site_by_name(site_name)
+      sites.select { |s| s.name == site_name }.first
+    end
+
+    def full_site(id)
+      client_for_site(client.get(Resources::Site.location(path, id)).content_url).get Resources::Site.location(path, id)
     end
 
     def schedules
@@ -32,7 +54,35 @@ module TableauServerClient
 
     private
 
-    attr_reader :client
+    attr_reader :password
+
+    def client
+      @client ||= client_for_site(content_url)
+    end
+
+    def client_for_site(_content_url)
+      Client.new(server_url, username, password, _content_url, api_version, token_lifetime, @logger, impersonation_user_id)
+    end
+
+    def site_id
+      admin_client.get_collection(Resources::Site.location(path)).each do |site|
+        if site.content_url == content_url
+          return site.id
+        end
+      end
+    end
+
+    def impersonation_user_id
+      return @impersonation_user_id if @impersonation_user_id
+      return nil unless impersonation_username
+      user = admin_client.get(Resources::Site.location(path, site_id)).users(filter: ["name:eq:#{impersonation_username}"]).first
+      return @impersonation_user_id = user.id if user
+      raise TableauServerClientError.new("User '#{username}' not found.")
+    end
+
+    def admin_client
+      @admin_client ||= Client.new(server_url, username, password, content_url, api_version, token_lifetime, @logger, nil)
+    end
 
   end
 end

data/lib/tableau_server_client/version.rb

@@ -1,3 +1,3 @@
 module TableauServerClient
-  VERSION = "0.0.19"
+  VERSION = "0.4.1"
 end

data/tableau_server_client.gemspec

@@ -21,8 +21,8 @@ Gem::Specification.new do |spec|
   spec.executables   = ["console"]
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.13"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler", "~> 2.1"
+  spec.add_development_dependency "rake", "~> 12.3.3"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "byebug"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tableau_server_client
 version: !ruby/object:Gem::Version
-  version: 0.0.19
+  version: 0.4.1
 platform: ruby
 authors:
 - shimpeko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-17 00:00:00.000000000 Z
+date: 2020-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -137,6 +137,7 @@ files:
 - bin/console
 - lib/tableau_server_client.rb
 - lib/tableau_server_client/client.rb
+- lib/tableau_server_client/exception.rb
 - lib/tableau_server_client/paginatable_response.rb
 - lib/tableau_server_client/request_builder.rb
 - lib/tableau_server_client/request_url.rb
@@ -144,6 +145,7 @@ files:
 - lib/tableau_server_client/resources/datasource.rb
 - lib/tableau_server_client/resources/downloadable.rb
 - lib/tableau_server_client/resources/extract_refresh.rb
+- lib/tableau_server_client/resources/group.rb
 - lib/tableau_server_client/resources/job.rb
 - lib/tableau_server_client/resources/project.rb
 - lib/tableau_server_client/resources/resource.rb
@@ -151,6 +153,7 @@ files:
 - lib/tableau_server_client/resources/site.rb
 - lib/tableau_server_client/resources/subscription.rb
 - lib/tableau_server_client/resources/user.rb
+- lib/tableau_server_client/resources/view.rb
 - lib/tableau_server_client/resources/workbook.rb
 - lib/tableau_server_client/server.rb
 - lib/tableau_server_client/token.rb
@@ -175,8 +178,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Tableau Server REST API Client