gitlab-customer-support-operations_zendesk 1.0.0

data/lib/support_ops_zendesk/zendesk/oauth_tokens.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class OAuthTokens within the module {SupportOps::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Integer] client_id The id of the client this token belongs to
+    # @attr [String] created_at The time the token was created
+    # @attr [String] expires_at The time the token will expire
+    # @attr [Integer] id Automatically assigned upon creation
+    # @attr [String] refresh_token The refresh token, if generated
+    # @attr [Array] scopes An array of the valid scopes for this token.
+    # @attr [String] token The access token
+    # @attr [String] used_at The latest time this token was used for authentication
+    # @attr [Integer] user_id The id of the user this token authenticates as
+    # @todo List Tokens => https://developer.zendesk.com/api-reference/ticketing/oauth/oauth_tokens/#list-tokens
+    # @todo Show Token => https://developer.zendesk.com/api-reference/ticketing/oauth/oauth_tokens/#show-token
+    class OAuthTokens < SupportOps::Zendesk::Base
+      # @!parse
+      #   # Creates an OAuth Token
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::Zendesk::OAuthTokens}
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#save!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/oauth/oauth_tokens/#create-token
+      #   #   Zendesk API > OAuth Tokens > Create Token
+      #   # @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_token = SupportOps::Zendesk::OAuthTokens.new
+      #   #   new_token.client_id = 1234
+      #   #   new_token.scopes = [
+      #   #     'impersonate',
+      #   #     'write'
+      #   #   ]
+      #   #
+      #   #   new_token.save!
+      #   #
+      #   #   pp new_token.full_token
+      #   #   # => "JskoTAaEACYey4pix43GDTEc4QQoHictFgHP79AH8s2XznVKtXHdj8YmoRbzcNiZ"
+      # @!parse
+      #   # Revokes an OAuth token
+      #   # 
+      #   # @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/oauth/oauth_tokens/#revoke-token
+      #   #   Zendesk API > OAuth Tokens > Revoke Token
+      #   # @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_token = SupportOps::Zendesk::OAuthTokens.new
+      #   #   new_token.client_id = 1234
+      #   #   new_token.scopes = [
+      #   #     'impersonate',
+      #   #     'write'
+      #   #   ]
+      #   #
+      #   #   new_token.save!
+      #   #   new_token.delete!
+      #   def delete!; end
+      define_attributes :client_id, :created_at, :expires_at, :id,
+                        :refresh_token, :scopes, :token, :used_at, :user_id
+      readonly_attributes :client_id, :created_at, :expires_at, :id,
+                          :refresh_token, :scopes, :token, :used_at, :user_id
+
+      private
+
+      ##
+      # @private
+      def create_record
+        data = {
+          'token' => {
+            'client_id' => self.client_id,
+            'scopes' => self.scopes
+          }
+        }.to_json
+        response = self.client.connection.post('oauth/tokens', data)
+        body = Oj.load(response.body)
+        raise "Failed to create OAuth token => #{body}" unless [200, 201].include?(response.status)
+        body['token']
+      end
+
+      ##
+      # @private
+      def delete_record
+        response = self.client.connection.delete("oauth/tokens/#{self.id}")
+        raise "Failed to delete OAuth token => #{body}" if response.status != 204
+        true
+      end
+    end
+  end
+end

data/lib/support_ops_zendesk/zendesk/organization_fields.rb

@@ -0,0 +1,282 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class OrganizationFields within the module {SupportOps::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Boolean] active If true, this field is available for use
+    # @attr [String] created_at The time of the last update of the ticket field
+    # @attr [Array] custom_field_options Required and presented for a custom field of type "dropdown", each option is represented by an object with a name and value property
+    # @attr [String] description User-defined description of this field's purpose
+    # @attr [Integer] id Automatically assigned upon creation
+    # @attr [String] key A unique key that identifies this custom field; this is used for updating the field and referencing in placeholders; the key must consist of only letters, numbers, and underscores; it can't be only numbers
+    # @attr [Integer] position Ordering of the field relative to other fields
+    # @attr [String] raw_description The dynamic content placeholder, if present, or the description value, if not
+    # @attr [String] raw_title The dynamic content placeholder, if present, or the title value, if not
+    # @attr [String] regexp_for_validation The validation pattern for a field value to be deemed valid
+    # @attr [Hash] relationship_filter A filter definition that allows your autocomplete to filter down results
+    # @attr [String] relationship_target_type A representation of what type of object the field references; options are "zen:user", "zen:organization", "zen:ticket", and "zen:custom_object:{key}" where key is a custom object key (for example "zen:custom_object:apartment")
+    # @attr [Boolean] system If true, only active and position values of this field can be changed
+    # @attr [String] tag Optional for custom field of type "checkbox"; not presented otherwise
+    # @attr [String] title The title of the custom field
+    # @attr [String] type The custom field type: "checkbox", "date", "decimal", "dropdown", "integer", "lookup", "multiselect", "regexp", "text", or "textarea"
+    # @attr [String] updated_at The time of the last update of the ticket field
+    class OrganizationFields < SupportOps::Zendesk::Base
+      # @!parse
+      #   # Creates/updates an organization field
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::Zendesk::OrganizationFields}
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#save!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/#create-organization-field
+      #   #   Zendesk API > Organization Fields > Create Organization Field
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/#update-organization-field
+      #   #   Zendesk API > Organization Fields > Update Organization Field
+      #   # @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_field = SupportOps::Zendesk::OrganizationFields.new
+      #   #   new_field.title = 'Support description'
+      #   #   new_field.type = 'text'
+      #   #   new_field.description = 'This field describes the support plan this organization has'
+      #   #   new_field.key = 'support_description'
+      #   #
+      #   #   new_field.save!
+      #   #
+      #   #   pp new_field.id
+      #   #   # => 23409462
+      #   # @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_field = SupportOps::Zendesk::OrganizationFields.get!(23409462)
+      #   #   existing_field.title = 'Support description (text)'
+      #   #
+      #   #   existing_field.save!
+      #   #
+      #   #   pp existing_field.title
+      #   #   # => "Support description (text)"
+      #   def save!; end
+      # @!parse
+      #   # Deletes an organization field
+      #   # 
+      #   # @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/organizations/organization_fields/#delete-organization-field
+      #   #   Zendesk API > Organization Fields > Update Organization Field
+      #   # @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_field = SupportOps::Zendesk::OrganizationFields.get!(23409462)
+      #   #   existing_field.delete!
+      #   def delete!; end
+      define_attributes :active, :created_at, :custom_field_options,
+                        :description, :id, :key, :position, :raw_description,
+                        :raw_title, :regexp_for_validation,
+                        :relationship_filter, :relationship_target_type,
+                        :system, :tag, :title, :type, :updated_at
+      readonly_attributes :created_at, :id, :system, :updated_at
+
+      ##
+      # Lists organization fields in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param limit [Integer optional] The limit to the number of
+      #     organization fields returned. Default to 0 (i.e. no limit)
+      # @return [Array]
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/#list-organization-fields
+      #   Zendesk API > Organization Fields > List Organization Fields
+      # @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
+      #
+      #   fields = SupportOps::Zendesk::OrganizationFields.list(limit: 10)
+      #   pp fields.count
+      #   # => 10
+      #   pp fields.last.title
+      #   # => "I'm the 10th organization field"
+      def self.list(**args)
+        args[:limit] = 0 unless args[:limit]
+        array = []
+        opts = 'page[size]=100'
+        loop do
+          response = client.connection.get("organization_fields?#{opts}")
+          body = Oj.load(response.body)
+          array += body['organization_fields'].map { |o| OrganizationFields.new(o) }
+          break if args[:limit].to_i.positive? && array.count >= args[:limit].to_i
+          break unless body['meta']['has_more']
+
+          opts = body['links']['next'].split('?').last
+        end
+        return array if args[:limit].to_i.zero?
+        
+        array.first(args[:limit].to_i)
+      end
+
+      ##
+      # Locates a specific organization field in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/#show-organization-field
+      #   Zendesk API > Organization Field > Show Organization Field
+      # @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
+      #
+      #   field = SupportOps::Zendesk::OrganizationFields.get(25)
+      #   pp field.title
+      #   # => "I'm the 25th organization field"
+      def self.get(object)
+        if object.is_a? OrganizationFields
+          OrganizationFields.new(id: id).find
+        else
+          OrganizationFields.new(id: object).find
+        end
+      end
+
+      ##
+      # Locates a specific organization field in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/#show-organization-field
+      #   Zendesk API > Organization Field > Show Organization Field
+      # @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
+      #
+      #   field = SupportOps::Zendesk::OrganizationFields.get!(25)
+      #   pp field.title
+      #   # => "I'm the 25th organization field"
+      def self.get!(object)
+        if object.is_a? OrganizationFields
+          OrganizationFields.new(id: id).find!
+        else
+          OrganizationFields.new(id: object).find!
+        end
+      end
+
+      ##
+      # Reorders the organization field positions in Zendesk. Must include all of them.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param field_ids [Array] The IDs of organization fields in the new order
+      # @see
+      #   https://developer.zendesk.com/api-reference/ticketing/organizations/organization_fields/#reorder-organization-field
+      #   Zendesk API > Organization Fields > Reorder Organization Field
+      # @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
+      #
+      #   pp SupportOps::Zendesk::OrganizationFields.reorder!([25, 38, 24, 37])
+      #   # => true
+      def self.reorder!(field_ids)
+        current_order = list.sort_by { |l| l.position }.map { |l| l.id }
+        raise 'You must include all organization field IDs here' unless field_ids.count == current_order.count
+        raise 'You did not make any changes' if current_order == field_ids
+        data = { organization_field_ids: field_ids }.to_json
+        response = client.connection.put('organization_fields/reorder', data)
+        body = Oj.load(response.body)
+        raise "Unable to reorder organization fields => #{body}" if response.status != 200
+        true
+      end
+
+      private
+
+      ##
+      # @private
+      def get_record
+        response = self.client.connection.get("organization_fields/#{self.id}")
+        return nil if response.status != 200
+
+        Oj.load(response.body)['organization_field']
+      end
+
+      ##
+      # @private
+      def create_record
+        response = self.client.connection.post("organization_fields", { organization_field: attributes_for_save }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create organization field => #{body['details']}" if response.status != 201
+        body['organization_field']
+      end
+
+      ##
+      # @private
+      def update_record
+        raise "Failed to update automation => You didn't change anything in the object" if attributes_for_save.keys == [:id]
+        response = self.client.connection.put("organization_fields/#{self.id}", { organization_field: attributes_for_save }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to update organization field #{self.id} => #{body['details']}" if response.status != 200
+        body['organization_field']
+      end
+
+      ##
+      # @private
+      def delete_record
+        response = self.client.connection.delete("organization_fields/#{self.id}")
+        raise "Failed to delete organization field => #{body['details']}" if response.status != 204
+        true
+      end
+    end
+  end
+end