gitlab-customer-support-operations_zendesk 1.0.0

data/lib/support_ops_zendesk/zendesk/views.rb

@@ -0,0 +1,636 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class Views within the module {SupportOps::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Boolean] active Whether the view is active
+    # @attr [Hash] conditions Describes how the view is constructed
+    # @attr [String] created_at The time the view was created
+    # @attr [Boolean] default If true, the view is a default view
+    # @attr [String] description The description of the view
+    # @attr [Hash] execution Describes how the view should be executed
+    # @attr [Integer] id Automatically assigned when created
+    # @attr [Integer] position The position of the view
+    # @attr [Hash] restriction Who may access this account. Is null when everyone in the account can access it
+    # @attr [String] title The title of the view
+    # @attr [String] updated_at The time the view was last updated
+    # @todo List Views - Compact => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#list-views---compact
+    # @todo Search Views => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#search-views
+    # @todo Preview Ticket Count => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#preview-ticket-count
+    # @todo Execute View => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#execute-view
+    # @todo Count Tickets in View => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#count-tickets-in-view
+    # @todo Count Tickets in Views => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#count-tickets-in-views
+    # @todo Export View => https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#export-view
+    class Views < SupportOps::Zendesk::Base
+      # @!parse
+      #   # Creates/updates a view
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::Zendesk::Views}
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#save!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#create-view
+      #   #   Zendesk API > Views > Create View
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#update-view
+      #   #   Zendesk API > Views > Update View
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   new_view = SupportOps::Zendesk::Views.new
+      #   #   new_view.title = "Kelly's tickets"
+      #   #   new_view.description = 'Tickets that are assigned to Kelly'
+      #   #   new_view.active = true
+      #   #   new_view.position = 3
+      #   #   new_view.conditions = {
+      #   #     "all" => [
+      #   #       { "field" => 'status', "operator" => 'less_than', "value" => 'solved' }
+      #   #     ],
+      #   #     "any" => []
+      #   #   }
+      #   #   new_view.execution = {
+      #   #     "columns" => [
+      #   #       { "id" => 'status', "title" => 'Status', "filterable" => true, "sortable" => true},
+      #   #       { "id" => 'requester', "title" => 'Requester', "filterable" => true, "sortable" => true},
+      #   #       { "id" => 'assignee', "title" => 'Assignee', "filterable" => true, "sortable" => true},
+      #   #     ],
+      #   #     "group_by" => 'assignee',
+      #   #     "group_order" => 'desc',
+      #   #     "sort_by" => 'status',
+      #   #     "sort_order" => 'desc',
+      #   #     "group" => {
+      #   #       "id" => 'assignee',
+      #   #       "title" => 'Assignee',
+      #   #       "filterable" => true,
+      #   #       "sortable" => true,
+      #   #       "order" => 'desc'
+      #   #     },
+      #   #     "sort" => {
+      #   #       "id" => 'status',
+      #   #       "title" => 'Status',
+      #   #       "filterable" => true,
+      #   #       "sortable" => true,
+      #   #       "order" => 'desc'
+      #   #     }
+      #   #   }
+      #   #
+      #   #   new_view.save!
+      #   #
+      #   #   pp new_view.id
+      #   #   # => 123
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_view = SupportOps::Zendesk::Views.get!(9873843)
+      #   #   existing_view.title = 'Canada tickets'
+      #   #
+      #   #   existing_view.save!
+      #   #
+      #   #   pp existing_view.title
+      #   #   # => "Canada tickets"
+      #   def save!; end
+      # @!parse
+      #   # Deletes a view
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#delete!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#delete-view
+      #   #   Zendesk API > Views > Delete View
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_view = SupportOps::Zendesk::Views.get!(9873843)
+      #   #   existing_view.delete!
+      #   def delete!; end
+      # @!parse
+      #   # Lists tickets from a view
+      #   #
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object]
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#tickets}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#list-tickets-from-a-view
+      #   #   Zendesk API > Views > List Tickets From a View
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   view = SupportOps::Zendesk::Views.get!(17258763336988)
+      #   #   tickets = view.tickets
+      #   #
+      #   #   pp tickets.first.status
+      #   #   # => "pending"
+      #   def tickets; end
+      # @!parse
+      #   # Previews what a view would look like
+      #   #
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object]
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#preview!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#preview-views
+      #   #   Zendesk API > Views > Preview View
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_view = SupportOps::Zendesk::Views.get!(9873858)
+      #   #   preview = existing_view.preview!
+      #   #   pp preview['rows']['tickets'].first['id']
+      #   #   # => 12851
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   new_view = SupportOps::Zendesk::Views.new
+      #   #   new_view.conditions = {
+      #   #     "all" => [
+      #   #       { "field" => 'status', "operator" => 'less_than', "value" => 'solved' }
+      #   #     ],
+      #   #     "any" => []
+      #   #   }
+      #   #   new_view.execution = {
+      #   #     "columns" => [
+      #   #       { "id" => 'status', "title" => 'Status', "filterable" => true, "sortable" => true},
+      #   #       { "id" => 'requester', "title" => 'Requester', "filterable" => true, "sortable" => true},
+      #   #       { "id" => 'assignee', "title" => 'Assignee', "filterable" => true, "sortable" => true},
+      #   #     ],
+      #   #     "group_by" => 'assignee',
+      #   #     "group_order" => 'desc',
+      #   #     "sort_by" => 'status',
+      #   #     "sort_order" => 'desc',
+      #   #     "group" => {
+      #   #       "id" => 'assignee',
+      #   #       "title" => 'Assignee',
+      #   #       "filterable" => true,
+      #   #       "sortable" => true,
+      #   #       "order" => 'desc'
+      #   #     },
+      #   #     "sort" => {
+      #   #       "id" => 'status',
+      #   #       "title" => 'Status',
+      #   #       "filterable" => true,
+      #   #       "sortable" => true,
+      #   #       "order" => 'desc'
+      #   #     }
+      #   #   }
+      #   #   preview = new_view.preview!
+      #   #   pp preview['rows']['tickets'].first['id']
+      #   #   # => 21516
+      #   def preview!; end
+      define_attributes :active, :conditions, :created_at, :default,
+                        :description, :execution, :id, :position, :restriction,
+                        :title, :updated_at
+      readonly_attributes :created_at, :default, :id, :updated_at
+
+      ##
+      # Lists views in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param access [String optional] Only views with given access. May be
+      #     "personal", "shared", or "account"
+      #   @param active [Boolean optional]Only active views if true, inactive
+      #     views if false
+      #   @param group_id [Integer optional] Only views belonging to given group
+      #   @param sort_by [String optional] Possible values are "alphabetical",
+      #     "created_at", or "updated_at". Defaults to "position"
+      #   @param sort_order [String optional] One of "asc" or "desc". Defaults to "asc" for alphabetical and position
+      #     sort, "desc" for all others
+      #   @param limit [Integer optional] The limit to the number of webhooks
+      # @return [Array]
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#list-views
+      #   Zendesk API > Views > List Views
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   views = SupportOps::Zendesk::Views.list(active: true, group_id: 12510506606620, limit: 25)
+      #   pp views.count
+      #   # => 8
+      def self.list(**args)
+        args[:access] = nil unless args[:access]
+        args[:active] = nil unless args[:active]
+        args[:group_id] = nil unless args[:group_id]
+        args[:sort_by] = nil unless args[:sort_by]
+        args[:sort_order] = nil unless args[:sort_order]
+        args[:limit] = 0 unless args[:limit]
+        params = ''
+        params += "access=#{args[:access]}&" unless args[:access].nil?
+        params += "active=#{args[:active]}&" unless args[:active].nil?
+        params += "group_id=#{args[:group_id]}&" unless args[:group_id].nil?
+        params += "sort_by=#{args[:sort_by]}&" unless args[:sort_by].nil?
+        params += "sort_order=#{args[:sort_order]}&" unless args[:sort_order].nil?
+        views = []
+        opts = "#{params}page[size]=100"
+        loop do
+          response = client.connection.get("views?#{opts}")
+          body = Oj.load(response.body)
+          views += body['views'].map { |v| Views.new(v) }
+          break if args[:limit].to_i.positive? && views.count >= args[:limit].to_i
+          break unless body['meta']['has_more']
+
+          opts = body['links']['next'].split('?').last
+        end
+        return views if args[:limit].to_i.zero?
+        
+        views.first(args[:limit].to_i)
+      end
+
+      ##
+      # Returns an approximate count of views in the account. If the count exceeds 100,000, it is updated every 24 hours.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @return [Hash]
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#count-views
+      #   Zendesk API > Views > Count Views
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   orgs = SupportOps::Zendesk::Views.count
+      #   pp orgs['value']
+      #   # => 102
+      def self.count
+        response = client.connection.get('views/count')
+        Oj.load(response.body)['count']
+      end
+
+      ##
+      # Lists active views in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list_active(key: value)
+      #   @param access [String optional] Only views with given access. May be
+      #     "personal", "shared", or "account"
+      #   @param group_id [Integer optional] Only views belonging to given group
+      #   @param sort_by [String optional] Possible values are "alphabetical",
+      #     "created_at", or "updated_at". Defaults to "position"
+      #   @param sort_order [String optional] One of "asc" or "desc". Defaults to "asc" for alphabetical and position
+      #     sort, "desc" for all others
+      #   @param limit [Integer optional] The limit to the number of webhooks
+      # @return [Array]
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#list-active-views
+      #   Zendesk API > Views > List Active Views
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   views = SupportOps::Zendesk::Views.list_active(group_id: 12510506606620, limit: 25)
+      #   pp views.count
+      #   # => 8
+      def self.list_active(**args)
+        args[:access] = nil unless args[:access]
+        args[:group_id] = nil unless args[:group_id]
+        args[:sort_by] = nil unless args[:sort_by]
+        args[:sort_order] = nil unless args[:sort_order]
+        args[:limit] = 0 unless args[:limit]
+        params = ''
+        params += "access=#{args[:access]}&" unless args[:access].nil?
+        params += "group_id=#{args[:group_id]}&" unless args[:group_id].nil?
+        params += "sort_by=#{args[:sort_by]}&" unless args[:sort_by].nil?
+        params += "sort_order=#{args[:sort_order]}&" unless args[:sort_order].nil?
+        page = 1
+        views = []
+        loop do
+          response = client.connection.get("views/active?#{params}page=#{page}")
+          body = Oj.load(response.body)
+          views += body['views'].map { |v| Views.new(v) }
+          break if args[:limit].to_i.positive? && views.count >= args[:limit].to_i
+          break if body['views'].count < 100
+
+          page += 1
+        end
+        return views if args[:limit].to_i.zero?
+        
+        views.first(args[:limit].to_i)
+      end
+
+      ##
+      # Locates a specific view in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#show-view
+      #   Zendesk API > Views > Show View
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   views = SupportOps::Zendesk::Views.get(25)
+      #   pp view.title
+      #   # => "I'm the 25th view"
+      def self.get(object)
+        if object.is_a? Views
+          Views.new(id: id).find
+        else
+          Views.new(id: object).find
+        end
+      end
+
+      ##
+      # Locates a specific view in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#show-view
+      #   Zendesk API > Views > Show View
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   views = SupportOps::Zendesk::Views.get!(25)
+      #   pp view.title
+      #   # => "I'm the 25th view"
+      def self.get!(object)
+        if object.is_a? Views
+          Views.new(id: id).find!
+        else
+          Views.new(id: object).find!
+        end
+      end
+
+      ##
+      # Locates up to 100 views within Zendesk.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param view_ids [Array] The view IDs to find
+      # @return [Array]
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#list-views-by-id
+      #   Zendesk API > Views > Show Views By ID
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   views = SupportOps::Zendesk::Views.get_many([255, 256])
+      #   pp views.map { |t| t.title }
+      #   # => ["View 255", "256th View"]
+      def self.get_many(view_ids)
+        raise 'The parameter must be an Array' unless view_ids.is_a? Array
+        raise 'You can only get a maximum of 100 views at a time' if view_ids.count > 100
+
+        response = client.connection.get("views/show_many?ids=#{view_ids.join(',')}")
+        Oj.load(response.body)['views'].map { |v| Views.new(v) }
+      end
+
+      ##
+      # Returns a Hash used in creating/updating views, as the formatting does not match the Zendesk list functions
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param view [Object] An instance of {SupportOps::Zendesk::Views}
+      # @return [Hash]
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   view = SupportOps::Zendesk::Views.get!(9873858)
+      #   object = SupportOps::Zendesk::Views.create_or_update_object(view)
+      #   pp object[:id]
+      #   # => 9873858
+      def self.create_or_update_object(view)
+        {
+          id: view.id,
+          title: view.title,
+          description: view.description,
+          active: view.active,
+          position: view.position,
+          restriction: view.restriction,
+          all: view.conditions['all'],
+          any: view.conditions['any'],
+          output: {
+            columns: view.execution['columns'].map { |c| c['id'] },
+            group_by: view.execution['group_by'],
+            group_order: view.execution['group_order'],
+            sort_by: view.execution['sort_by'],
+            sort_order: view.execution['sort_order']
+          }
+        }.compact
+      end
+
+      ##
+      # Deletes multiple views via a batch job
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param view_ids [Array] An array of view IDs
+      # @return [object] A {SupportOps::Zendesk::JobStatuses} instance
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#bulk-delete-views
+      #   Zendesk API > views > Bulk Delete Views
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   delete = SupportOps::Zendesk::Views.delete_many!([123, 456])
+      #   pp delete.id
+      #   # => "82de0b044094f0c67893ac9fe64f1a99"
+      def self.delete_many!(view_ids)
+        raise 'The parameter must be an Array' unless view_ids.is_a? Array
+        raise 'You can only delete a maximum of 100 views at a time' if view_ids.count > 100
+
+        response = client.connection.delete("views/destroy_many?ids=#{view_ids.join(',')}")
+        raise "Failed to delete views => #{body['details']}" if response.status != 200
+        JobStatuses.new(Oj.load(response.body)['job_status'])
+      end
+
+      ##
+      # Updates multiple views via a batch job
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param views [Array] An array of {SupportOps::Zendesk::Views} instances
+      # @return [object] A {SupportOps::Zendesk::JobStatuses} instance
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/business-rules/views/#update-many-views
+      #   Zendesk API > Views > Update Many Views
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   view1 = SupportOps::Zendesk::Views.get!(123)
+      #   view1.title = 'Org for Alice Company'
+      #   view2 = SupportOps::Zendesk::Views.get!(456)
+      #   view2.title = 'Org for Bob Company'
+      #
+      #   updates = SupportOps::Zendesk::Views.update_many!([view1, view2])
+      #   pp updates.id
+      #   # => "82de0b044094f0c67893ac9fe64f1a99"
+      def self.update_many!(views)
+        raise 'The parameter must be an Array' unless views.is_a? Array
+        raise 'You can only update a maximum of 100 views at a time' if views.count > 100
+        raise 'You can only use SupportOps::Zendesk::Views instances in the Array' unless views.reject { |o| o.is_a? SupportOps::Zendesk::Views }.count.zero?
+
+        data = { views: views.map { |v| Views.create_or_update_object(v) } }.to_json
+        response = client.connection.put('views/update_many', data)
+        raise "Failed to update views => #{body['details']}" if response.status != 200
+        JobStatuses.new(Oj.load(response.body)['job_status'])
+      end
+
+      private
+
+      ##
+      # @private
+      def get_record
+        response = self.client.connection.get("views/#{self.id}")
+        return nil if response.status != 200
+
+        Oj.load(response.body)['view']
+      end
+
+      ##
+      # @private
+      def create_record
+        response = self.client.connection.post("views", { view: Views.create_or_update_object(self) }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create view => #{body['details']}" if response.status != 201
+        body['view']
+      end
+
+      ##
+      # @private
+      def update_record
+        raise "Failed to update view => You didn't change anything in the object" if attributes_for_save.keys == [:id]
+        response = self.client.connection.put("views/#{self.id}", { view: Views.create_or_update_object(self) }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to update view #{self.id} => #{body['details']}" if response.status != 200
+        body['view']
+      end
+
+      ##
+      # @private
+      def delete_record
+        response = self.client.connection.delete("views/#{self.id}")
+        raise "Failed to delete view => #{body['details']}" if response.status != 204
+        true
+      end
+
+      ##
+      # @private
+      def tickets_record
+        response = self.client.connection.get("views/#{self.id}/tickets")
+        Oj.load(response.body)['tickets'].map { |t| Tickets.new(t) }
+      end
+
+      ##
+      # @private
+      def preview_record
+        converted = Views.create_or_update_object(self)
+        data = {
+          all: converted[:all],
+          any: converted[:any],
+          output: converted[:output]
+        }.compact
+        response = self.client.connection.post('views/preview', { view: data }.to_json)
+        body = Oj.load(response.body)
+        raise "Unable to generate a preview => #{body}" if response.status != 200
+        body
+      end
+    end
+  end
+end