gitlab_support_readiness 1.0.117 → 1.0.119

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cf9fab733d81a7aa5c5c5d9e471a0f227c8d18a054c8dc0c9da5f968697a107
-  data.tar.gz: c0203eb2c3522b57969e8ec42b85115e994ebbe619de02024e832e0f9e349e7b
+  metadata.gz: 5a2b0108587e5e82022714ed390e5810b3fc139fe9192649b1216b18a957605a
+  data.tar.gz: 70948909b5727d437b9c396abdc6bd07c36273a297cbb9ebfd5e47f27dcef842
 SHA512:
-  metadata.gz: 41579e75455d37c9139d7df45f2a413cdf5629469e51977af063e1bea5b28c024ce7c8222d4ab6da3a5aa0a4c8f12cf6a11e6fe399fe51702c931be1362465f5
-  data.tar.gz: 1931b9f5d11cf0fdab299ea3a73c31256d73d309510c996a176f598d7bebe1d4df201ef23b3da8b2b45ba61afe5a070fe26b041c81593562b633124351844d3a
+  metadata.gz: 923828b4dc892451fb3d542503bd46a70cc115e99a258558160c2fee030e90210de87b66521ce015b687c98c4c101ab92cfdaa53d7a69dba7fd5427684c5ccc5
+  data.tar.gz: fdfca9336366bea66430ee3d2acb3aecdfbcfa955f62509661dceb0127288baae3b4bc7fd3eccc18848e50ab23cee1effc12de071058b007db207bd0519959fb

data/lib/support_readiness/client.rb

@@ -336,6 +336,12 @@ module Readiness
     # @param object [Object] The object to parse
     def self.convert_actions(object)
       object['actions'].each_with_index do |a, i|
+        if a['field'] == 'brand_id'
+          brand = Readiness::Zendesk::Brands.find_by_name(@zendesk_client, a['value'], @brands)
+          unless brand.nil?
+            object['actions'][i]['value'] = brand.id.to_s
+          end
+        end
         if a['field'] == 'group_id'
           group = Readiness::Zendesk::Groups.find_by_name(@zendesk_client, a['value'], @groups)
           unless group.nil?
@@ -439,5 +445,82 @@ module Readiness
       end
       object
     end
+
+    ##
+    # Convert user friendly Strings into Zendesk values for ticket form objects
+    #
+    # @author Jason Colyer
+    # @since 1.0.118
+    # @param object [Object] The object to parse
+    def self.convert_ticket_form_names_to_ids(object)
+      new_object = covert_ticket_form_field_ids(object)
+      new_object = convert_ticket_form_end_user_conditions(new_object)
+      new_object = convert_ticket_form_agent_conditions(new_object)
+      convert_ticket_form_brands(new_object)
+    end
+
+    ##
+    # Convert user friendly Strings into Zendesk values for ticket form field IDs
+    #
+    # @author Jason Colyer
+    # @since 1.0.118
+    # @param object [Object] The ticket form to parse
+    def self.covert_ticket_form_field_ids(object)
+      object['ticket_field_ids'] = object['ticket_field_ids'].map do |f|
+        field = Readiness::Zendesk::TicketFields.find_by_name(@zendesk_client, f, @ticket_fields)
+        field.nil? ? f : field.id
+      end
+      object
+    end
+
+    ##
+    # Convert user friendly Strings into Zendesk values for ticket form end_user conditions
+    #
+    # @author Jason Colyer
+    # @since 1.0.118
+    # @param object [Object] The ticket form to parse
+    def self.convert_ticket_form_end_user_conditions(object)
+      object['end_user_conditions'].each_with_index do |c, ci|
+        parent_field = Readiness::Zendesk::TicketFields.find_by_name(@zendesk_client, c['parent_field_id'], @ticket_fields)
+        object['end_user_conditions'][ci]['parent_field_id'] = parent_field.id unless parent_field.nil?
+        c['child_fields'].each_with_index do |cf, cfi|
+          child_field = Readiness::Zendesk::TicketFields.find_by_name(@zendesk_client, cf['id'], @ticket_fields)
+          object['end_user_conditions'][ci]['child_fields'][cfi]['id'] = child_field.id unless child_field.nil?
+        end
+      end
+      object
+    end
+
+    ##
+    # Convert user friendly Strings into Zendesk values for ticket form agent conditions
+    #
+    # @author Jason Colyer
+    # @since 1.0.118
+    # @param object [Object] The ticket form to parse
+    def self.convert_ticket_form_agent_conditions(object)
+      object['agent_conditions'].each_with_index do |c, ci|
+        parent_field = Readiness::Zendesk::TicketFields.find_by_name(@zendesk_client, c['parent_field_id'], @ticket_fields)
+        object['agent_conditions'][ci]['parent_field_id'] = parent_field.id unless parent_field.nil?
+        c['child_fields'].each_with_index do |cf, cfi|
+          child_field = Readiness::Zendesk::TicketFields.find_by_name(@zendesk_client, cf['id'], @ticket_fields)
+          object['agent_conditions'][ci]['child_fields'][cfi]['id'] = child_field.id unless child_field.nil?
+        end
+      end
+      object
+    end
+
+    ##
+    # Convert user friendly Strings into Zendesk values for ticket form brands
+    #
+    # @author Jason Colyer
+    # @since 1.0.118
+    # @param object [Object] The ticket form to parse
+    def self.convert_ticket_form_brands(object)
+      object['restricted_brand_ids'] = object['restricted_brand_ids'].map do |b|
+        brand = Readiness::Zendesk::Brands.find_by_name(@zendesk_client, b, @brands)
+        brand.nil? ? b : brand.id
+      end
+      object
+    end
   end
 end

data/lib/support_readiness/repos/automations.rb

@@ -130,6 +130,7 @@ module Readiness
       #   pp repo.count
       #   # => 35
       def self.gather(location = 'data')
+        @brands = Readiness::Zendesk::Brands.list(@zendesk_client)
         @categories = Readiness::Zendesk::TriggerCategories.list(@zendesk_client)
         @groups = Readiness::Zendesk::Groups.list(@zendesk_client)
         @schedules = Readiness::Zendesk::Schedules.list(@zendesk_client)

data/lib/support_readiness/repos/macros.rb

@@ -48,6 +48,7 @@ module Readiness
       #   pp diffs[:updates.count]
       #   # => 1
       def self.compare(zendesk_client, location = 'data', verbose = false)
+        @zendesk_client = zendesk_client
         diffs = {
           updates: [],
           creates: []
@@ -129,12 +130,21 @@ module Readiness
       #   pp repo.count
       #   # => 35
       def self.gather(location = 'data')
+        @brands = Readiness::Zendesk::Brands.list(@zendesk_client)
+        @groups = Readiness::Zendesk::Groups.list(@zendesk_client)
+        @schedules = Readiness::Zendesk::Schedules.list(@zendesk_client)
+        @satisfaction_reasons = Readiness::Zendesk::SatisfactionReasons.list(@zendesk_client)
+        @targets = Readiness::Zendesk::Targets.list(@zendesk_client)
+        @ticket_fields = Readiness::Zendesk::TicketFields.list(@zendesk_client)
+        @ticket_forms = Readiness::Zendesk::TicketForms.list(@zendesk_client)
         @errors = []
         @location = location
         array = []
         Dir["#{@location}/**/*.yaml"].each do |f|
           object = YAML.safe_load_file(f)
           object = convert_managed_content(object) if object['contains_managed_content']
+          object = convert_actions(object)
+          object = convert_view_restrictions(object)
           validity_check(f, object)
           object['id'] = nil
           array.push(Zendesk::Macros.new(object))

data/lib/support_readiness/repos/sla_policies.rb

@@ -134,6 +134,7 @@ module Readiness
       #   pp repo.count
       #   # => 35
       def self.gather(location = 'data')
+        @brands = Readiness::Zendesk::Brands.list(@zendesk_client)
         @categories = Readiness::Zendesk::TriggerCategories.list(@zendesk_client)
         @groups = Readiness::Zendesk::Groups.list(@zendesk_client)
         @schedules = Readiness::Zendesk::Schedules.list(@zendesk_client)

data/lib/support_readiness/repos/ticket_forms.rb

@@ -48,6 +48,7 @@ module Readiness
       #   pp diffs[:updates.count]
       #   # => 1
       def self.compare(zendesk_client, location = 'data', verbose = false)
+        @zendesk_client = zendesk_client
         diffs = {
           updates: [],
           creates: []
@@ -138,11 +139,14 @@ module Readiness
       #   pp repo.count
       #   # => 35
       def self.gather(location = 'data')
+        @brands = Readiness::Zendesk::Brands.list(@zendesk_client)
+        @ticket_fields = Readiness::Zendesk::TicketFields.list(@zendesk_client)
         @errors = []
         @location = location
         array = []
         Dir["#{@location}/**/*.yaml"].each do |f|
           object = YAML.safe_load_file(f)
+          object = convert_ticket_form_names_to_ids(object)
           validity_check(f, object)
           object['id'] = nil
           array.push(Zendesk::TicketForms.new(object))

data/lib/support_readiness/repos/triggers.rb

@@ -135,6 +135,7 @@ module Readiness
       #   pp repo.count
       #   # => 35
       def self.gather(location = 'data')
+        @brands = Readiness::Zendesk::Brands.list(@zendesk_client)
         @categories = Readiness::Zendesk::TriggerCategories.list(@zendesk_client)
         @groups = Readiness::Zendesk::Groups.list(@zendesk_client)
         @schedules = Readiness::Zendesk::Schedules.list(@zendesk_client)

data/lib/support_readiness/repos/views.rb

@@ -136,6 +136,7 @@ module Readiness
       #   pp repo.count
       #   # => 35
       def self.gather(config, location = 'data')
+        @brands = Readiness::Zendesk::Brands.list(@zendesk_client)
         @groups = Readiness::Zendesk::Groups.list(@zendesk_client)
         @schedules = Readiness::Zendesk::Schedules.list(@zendesk_client)
         @satisfaction_reasons = Readiness::Zendesk::SatisfactionReasons.list(@zendesk_client)

data/lib/support_readiness/zendesk/brands.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class Brands within the module {Readiness::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.118
+    # @todo find
+    # @todo find!
+    # @todo Create
+    # @todo Update
+    # @todo Delete
+    # @todo Check Host Mapping Validity
+    # @todo Check Host Mapping Validity for an Existing Brand
+    class Brands < Readiness::Client
+      attr_accessor :active, :brand_url, :created_at, :default, :has_help_center, :help_center_state, :host_mapping, :id, :logo, :name, :signature_template, :subdomain, :ticket_form_ids, :updated_at      
+
+      ##
+      # Creates a new {Readiness::Zendesk::Brands} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.118
+      # @param object [Object] An instance of {Readiness::Zendesk::Brands}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::Zendesk::Brands.new
+      def initialize(object = {})
+        @active = object['active']
+        @brand_url = object['brand_url']
+        @created_at = object['created_at']
+        @default = object['default']
+        @has_help_center = object['has_help_center']
+        @help_center_state = object['help_center_state']
+        @host_mapping = object['host_mapping']
+        @id = object['id']
+        @logo = object['logo']
+        @name = object['name']
+        @signature_template = object['signature_template']
+        @subdomain = object['subdomain']
+        @ticket_form_ids = object['ticket_form_ids']
+        @updated_at = object['updated_at']
+      end
+
+      ##
+      # Lists all brands.
+      #
+      # @author Jason Colyer
+      # @since 1.0.118
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/account-configuration/brands/#list-brands Zendesk API > Brands > List Brands
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   brands = Readiness::Zendesk::Brands.list(client)
+      #   pp brands.count
+      #   # => 2
+      def self.list(client)
+        response = client.connection.get 'brands'
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        body = Oj.load(response.body)
+        body['brands'].map { |b| Brands.new(b) }
+      end
+
+      ##
+      # Locates a brand within Zendesk by name. Can utilize a cacheh for quicker results
+      #
+      # @author Jason Colyer
+      # @since 1.0.118
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param name [String] The brand name to look for
+      # @param cache [Array] The results of {Readiness::Zendesk::Brands#list}
+      # @return [Object] An instance of {Readiness::Zendesk::Brands}
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   brand = Readiness::Zendesk::Brands.find_by_name(client, 'Brand 1')
+      #   pp brand.id
+      #   # => 360002783572
+      def self.find_by_name(client, name, cache = nil)
+        brands = if cache.nil?
+                   Brands.list(client)
+                 else
+                   cache
+                 end
+        brands.detect { |f| f.name == name }
+      end
+    end
+  end
+end

data/lib/support_readiness/zendesk.rb

@@ -11,6 +11,7 @@ module Readiness
     require "#{__dir__}/zendesk/apps"
     require "#{__dir__}/zendesk/articles"
     require "#{__dir__}/zendesk/automations"
+    require "#{__dir__}/zendesk/brands"
     require "#{__dir__}/zendesk/client"
     require "#{__dir__}/zendesk/configuration"
     require "#{__dir__}/zendesk/dynamic_content"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab_support_readiness
 version: !ruby/object:Gem::Version
-  version: 1.0.117
+  version: 1.0.119
 platform: ruby
 authors:
 - Jason Colyer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-02-10 00:00:00.000000000 Z
+date: 2025-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -405,6 +405,7 @@ files:
 - lib/support_readiness/zendesk/apps.rb
 - lib/support_readiness/zendesk/articles.rb
 - lib/support_readiness/zendesk/automations.rb
+- lib/support_readiness/zendesk/brands.rb
 - lib/support_readiness/zendesk/client.rb
 - lib/support_readiness/zendesk/configuration.rb
 - lib/support_readiness/zendesk/dynamic_content.rb