aws-sdk-connectwisdomservice 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9aee9274a2aa582494d46a47e8244af47a82aecbb0fa8ca9d3f558e85f59d9f0
-  data.tar.gz: dfd396a0a3ec125c25f7ccf35109b900e4a652d390bd65590ceda6e18bfbd8c6
+  metadata.gz: 4efd36892803c90f1baffd440d5d725cd87fa1f6bc26a00bd4cf9de0b11bc379
+  data.tar.gz: 9055d54ce2fa8098de871998811af69082a4ac0b2ca62c8363bbc86dfd853505
 SHA512:
-  metadata.gz: 9e198dee36b953b9437c9e51955b62a7c3e3d0afecc798798fccca0c5e91fb4335557117414cdefa0b2fdeaca1e42ce104b1f5470300840c44e005a9195224ec
-  data.tar.gz: 02bc778f116ba22fd3e5e11a6db5b6fe22ad6f55774d3bf1ee923d521133f3a9352ccce65c3a241c5cf5e8fd05a61b988bf885fd19426e191128a00282833f7b
+  metadata.gz: 3f0eb1828d9539b380e8ef4fed74b77fa15cbb9a30cb647065e315bf8baf50be0b39f1516fbbf5a075c0c349dbff7383cdb7b86af3e17d1a576a2b2e1a6baf0c
+  data.tar.gz: b1208009ec30720882a61357a1b2809e9535635dbc1fabfea9c78a16004ff8d69f6640686745cd53c4cb50393cc31883a744237283958048bb37a315f74a4219

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.13.0 (2023-03-13)
+------------------
+
+* Feature - This release extends Wisdom CreateKnowledgeBase API to support SharePoint connector type by removing the @required trait for objectField
+
 1.12.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.12.0
+1.13.0

data/lib/aws-sdk-connectwisdomservice/client.rb

@@ -372,11 +372,17 @@ module Aws::ConnectWisdomService
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
     # @option params [String] :description
     #   The description of the assistant.
     #
@@ -448,11 +454,17 @@ module Aws::ConnectWisdomService
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
     # @option params [Hash<String,String>] :tags
     #   The tags used to organize, track, or control access for this resource.
     #
@@ -504,11 +516,17 @@ module Aws::ConnectWisdomService
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
     # @option params [required, String] :knowledge_base_id
     #   The identifier of the knowledge base. Can be either the ID or the ARN.
     #   URLs cannot contain the ARN.
@@ -602,21 +620,41 @@ module Aws::ConnectWisdomService
     # DataIntegrations with external knowledge bases such as Salesforce and
     # ServiceNow. If you do, you'll get an `InvalidRequestException` error.
     #
-    #       <p>For example, you're programmatically managing your external knowledge base, and you want to add or remove one of the fields that is being ingested from Salesforce. Do the following:</p> <ol> <li> <p>Call <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_DeleteKnowledgeBase.html">DeleteKnowledgeBase</a>.</p> </li> <li> <p>Call <a href="https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_DeleteDataIntegration.html">DeleteDataIntegration</a>.</p> </li> <li> <p>Call <a href="https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_CreateDataIntegration.html">CreateDataIntegration</a> to recreate the DataIntegration or a create different one.</p> </li> <li> <p>Call CreateKnowledgeBase.</p> </li> </ol> </note>
+    #  For example, you're programmatically managing your external knowledge
+    # base, and you want to add or remove one of the fields that is being
+    # ingested from Salesforce. Do the following:
+    #
+    #  1.  Call [DeleteKnowledgeBase][2].
+    #
+    # 2.  Call [DeleteDataIntegration][3].
+    #
+    # 3.  Call [CreateDataIntegration][4] to recreate the DataIntegration or
+    #     a create different one.
+    #
+    # 4.  Call CreateKnowledgeBase.
     #
     #  </note>
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/appintegrations/latest/APIReference/Welcome.html
+    # [2]: https://docs.aws.amazon.com/wisdom/latest/APIReference/API_DeleteKnowledgeBase.html
+    # [3]: https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_DeleteDataIntegration.html
+    # [4]: https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_CreateDataIntegration.html
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
     # @option params [String] :description
     #   The description.
     #
@@ -661,7 +699,7 @@ module Aws::ConnectWisdomService
     #     source_configuration: {
     #       app_integrations: {
     #         app_integration_arn: "GenericArn", # required
-    #         object_fields: ["NonEmptyString"], # required
+    #         object_fields: ["NonEmptyString"],
     #       },
     #     },
     #     tags: {
@@ -705,11 +743,17 @@ module Aws::ConnectWisdomService
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency, see
+    #   [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
+    #
     # @option params [String] :description
     #   The description.
     #
@@ -1966,7 +2010,7 @@ module Aws::ConnectWisdomService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-connectwisdomservice'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.13.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-connectwisdomservice/client_api.rb

@@ -171,7 +171,7 @@ module Aws::ConnectWisdomService
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
     AppIntegrationsConfiguration.add_member(:app_integration_arn, Shapes::ShapeRef.new(shape: GenericArn, required: true, location_name: "appIntegrationArn"))
-    AppIntegrationsConfiguration.add_member(:object_fields, Shapes::ShapeRef.new(shape: ObjectFieldsList, required: true, location_name: "objectFields"))
+    AppIntegrationsConfiguration.add_member(:object_fields, Shapes::ShapeRef.new(shape: ObjectFieldsList, location_name: "objectFields"))
     AppIntegrationsConfiguration.struct_class = Types::AppIntegrationsConfiguration
 
     AssistantAssociationData.add_member(:assistant_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "assistantArn"))

data/lib/aws-sdk-connectwisdomservice/endpoint_parameters.rb

@@ -50,9 +50,6 @@ module Aws::ConnectWisdomService
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

data/lib/aws-sdk-connectwisdomservice/endpoint_provider.rb

@@ -14,36 +14,39 @@ module Aws::ConnectWisdomService
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint)
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://wisdom-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://wisdom-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://wisdom.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://wisdom-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://wisdom-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://wisdom.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://wisdom.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://wisdom.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

data/lib/aws-sdk-connectwisdomservice/types.rb

@@ -29,11 +29,38 @@ module Aws::ConnectWisdomService
     # @!attribute [rw] app_integration_arn
     #   The Amazon Resource Name (ARN) of the AppIntegrations
     #   DataIntegration to use for ingesting content.
+    #
+    #   * For [ Salesforce][1], your AppIntegrations DataIntegration must
+    #     have an ObjectConfiguration if objectFields is not provided,
+    #     including at least `Id`, `ArticleNumber`, `VersionNumber`,
+    #     `Title`, `PublishStatus`, and `IsDeleted` as source fields.
+    #
+    #   * For [ ServiceNow][2], your AppIntegrations DataIntegration must
+    #     have an ObjectConfiguration if objectFields is not provided,
+    #     including at least `number`, `short_description`, `sys_mod_count`,
+    #     `workflow_state`, and `active` as source fields.
+    #
+    #   * For [ Zendesk][3], your AppIntegrations DataIntegration must have
+    #     an ObjectConfiguration if `objectFields` is not provided,
+    #     including at least `id`, `title`, `updated_at`, and `draft` as
+    #     source fields.
+    #
+    #   * For [ SharePoint][4], your AppIntegrations DataIntegration must
+    #     have a FileConfiguration, including only file extensions that are
+    #     among `docx`, `pdf`, `html`, `htm`, and `txt`.
+    #
+    #
+    #
+    #   [1]: https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_objects_knowledge__kav.htm
+    #   [2]: https://developer.servicenow.com/dev.do#!/reference/api/rome/rest/knowledge-management-api
+    #   [3]: https://developer.zendesk.com/api-reference/help_center/help-center-api/articles/
+    #   [4]: https://learn.microsoft.com/en-us/sharepoint/dev/sp-add-ins/sharepoint-net-server-csom-jsom-and-rest-api-index
     #   @return [String]
     #
     # @!attribute [rw] object_fields
     #   The fields from the source that are made available to your agents in
-    #   Wisdom.
+    #   Wisdom. Optional if ObjectConfiguration is included in the provided
+    #   DataIntegration.
     #
     #   * For [ Salesforce][1], you must include at least `Id`,
     #     `ArticleNumber`, `VersionNumber`, `Title`, `PublishStatus`, and
@@ -43,6 +70,9 @@ module Aws::ConnectWisdomService
     #     `short_description`, `sys_mod_count`, `workflow_state`, and
     #     `active`.
     #
+    #   * For [ Zendesk][3], you must include at least `id`, `title`,
+    #     `updated_at`, and `draft`.
+    #
     #   Make sure to include additional fields. These fields are indexed and
     #   used to source recommendations.
     #
@@ -50,6 +80,7 @@ module Aws::ConnectWisdomService
     #
     #   [1]: https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/sforce_api_objects_knowledge__kav.htm
     #   [2]: https://developer.servicenow.com/dev.do#!/reference/api/rome/rest/knowledge-management-api
+    #   [3]: https://developer.zendesk.com/api-reference/help_center/help-center-api/articles/
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/wisdom-2020-10-19/AppIntegrationsConfiguration AWS API Documentation
@@ -506,10 +537,16 @@ module Aws::ConnectWisdomService
     #
     # @!attribute [rw] client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency,
+    #   see [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -543,10 +580,16 @@ module Aws::ConnectWisdomService
 
     # @!attribute [rw] client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency,
+    #   see [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -597,10 +640,16 @@ module Aws::ConnectWisdomService
 
     # @!attribute [rw] client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency,
+    #   see [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
     #   @return [String]
     #
     # @!attribute [rw] knowledge_base_id
@@ -680,10 +729,16 @@ module Aws::ConnectWisdomService
 
     # @!attribute [rw] client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency,
+    #   see [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -753,10 +808,16 @@ module Aws::ConnectWisdomService
     #
     # @!attribute [rw] client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
+    #   idempotency of the request. If not provided, the Amazon Web Services
+    #   SDK populates this field. For more information about idempotency,
+    #   see [Making retries safe with idempotent APIs][1].
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.
+    #
+    #
+    #
+    #   [1]: https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -1774,7 +1835,7 @@ module Aws::ConnectWisdomService
     # @!attribute [rw] template_uri
     #   A URI template containing exactly one variable in `$\{variableName\}
     #   `format. This can only be set for `EXTERNAL` knowledge bases. For
-    #   Salesforce and ServiceNow, the variable must be one of the
+    #   Salesforce, ServiceNow, and Zendesk, the variable must be one of the
     #   following:
     #
     #   * Salesforce: `Id`, `ArticleNumber`, `VersionNumber`, `Title`,
@@ -1782,9 +1843,15 @@ module Aws::ConnectWisdomService
     #
     #   * ServiceNow: `number`, `short_description`, `sys_mod_count`,
     #     `workflow_state`, or `active`
-    #   ^
     #
-    #        <p>The variable is replaced with the actual value for a piece of content when calling <a href="https://docs.aws.amazon.com/wisdom/latest/APIReference/API_GetContent.html">GetContent</a>. </p>
+    #   * Zendesk: `id`, `title`, `updated_at`, or `draft`
+    #
+    #   The variable is replaced with the actual value for a piece of
+    #   content when calling [GetContent][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/wisdom/latest/APIReference/API_GetContent.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/wisdom-2020-10-19/RenderingConfiguration AWS API Documentation

data/lib/aws-sdk-connectwisdomservice.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-connectwisdomservice/customizations'
 # @!group service
 module Aws::ConnectWisdomService
 
-  GEM_VERSION = '1.12.0'
+  GEM_VERSION = '1.13.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-connectwisdomservice
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core