Merge branch 'master' into release

Author: YaroslawEkimov

README.md

@@ -13,12 +13,19 @@ This repository contains Aspose.Words Cloud SDK for Ruby source code. This SDK a
 * Watermarks and protection
 * Full read & write access to Document Object Model, including sections, paragraphs, text, images, tables, headers/footers and many others
 
+## Enhancements in Version 22.4
+
+- Added ExportShapesAsSvg to HtmlSaveOption.
+- Added new endpoint '~/styles/copy_from'.
+
+
 ## Enhancements in Version 22.3
 
 - Online methods returns the dictionary of files with included original filename as key instead of single file content in responses.
 - Parameters contained sensitive data should be passed in encrypted form. Names of the parameters have 'encrypted' prefix.
 - Added Encrypt method to encrypt data on the API public key. Use it to prepare values for parameters required encrypted data.
 - GetPublicKey method is not billable.
+- Changed type of enumerations for members of SaveOptionsData and other inherited classes from string to enum.
 
 
 ## Enhancements in Version 22.2
@@ -193,7 +200,7 @@ To use Aspose Words for Cloud Ruby SDK you need to register an account with [Asp
 To install this package do the following:
 update your Gemfile
 ```ruby
-gem 'aspose_words_cloud', '~> 22.3'
+gem 'aspose_words_cloud', '~> 22.4'
 ```
 or install directly
 ```bash

TestData/DocumentElements/Styles/StyleTemplate.docx

@@ -304,6 +304,7 @@
 require_relative 'aspose_words_cloud/models/requests/copy_folder_request'
 require_relative 'aspose_words_cloud/models/requests/copy_style_request'
 require_relative 'aspose_words_cloud/models/requests/copy_style_online_request'
+require_relative 'aspose_words_cloud/models/requests/copy_styles_from_template_request'
 require_relative 'aspose_words_cloud/models/requests/create_document_request'
 require_relative 'aspose_words_cloud/models/requests/create_folder_request'
 require_relative 'aspose_words_cloud/models/requests/create_or_update_document_property_request'

lib/aspose_words_cloud.rb

@@ -1395,6 +1395,82 @@ def copy_style_online(request)
         [mp_data, status_code, headers]
     end
 
+    # Copies styles from the origin document to the target document.
+    # @param request CopyStylesFromTemplateRequest
+    # @return [WordsResponse]
+    def copy_styles_from_template(request)
+        begin
+        data, _status_code, _headers = copy_styles_from_template_with_http_info(request)
+        rescue ApiError => e
+            if e.code == 401
+            request_token
+            data, _status_code, _headers = copy_styles_from_template_with_http_info(request)
+            else
+            raise
+            end
+        end
+        data
+    end
+
+    # Copies styles from the origin document to the target document.
+    # @param request CopyStylesFromTemplateRequest
+    # @return [Array<(WordsResponse, Fixnum, Hash)>]
+    # WordsResponse, response status code and response headers
+    private def copy_styles_from_template_with_http_info(request)
+        raise ArgumentError, 'Incorrect request type' unless request.is_a? CopyStylesFromTemplateRequest
+
+        @api_client.config.logger.debug 'Calling API: WordsApi.copy_styles_from_template ...' if @api_client.config.debugging
+        # verify the required parameter 'name' is set
+        raise ArgumentError, 'Missing the required parameter name when calling WordsApi.copy_styles_from_template' if @api_client.config.client_side_validation && request.name.nil?
+        # verify the required parameter 'template_name' is set
+        raise ArgumentError, 'Missing the required parameter template_name when calling WordsApi.copy_styles_from_template' if @api_client.config.client_side_validation && request.template_name.nil?
+
+        # resource path
+        local_var_path = '/words/{name}/styles/copy_from'[1..-1]
+        local_var_path = local_var_path.sub('{' + downcase_first_letter('Name') + '}', request.name.nil? ? '' : request.name.to_s)
+        local_var_path = local_var_path.sub('//', '/')
+
+        # query parameters
+        query_params = {}
+        query_params[downcase_first_letter('TemplateName')] = request.template_name
+        query_params[downcase_first_letter('Folder')] = request.folder unless request.folder.nil?
+        query_params[downcase_first_letter('Storage')] = request.storage unless request.storage.nil?
+        query_params[downcase_first_letter('LoadEncoding')] = request.load_encoding unless request.load_encoding.nil?
+        query_params[downcase_first_letter('Password')] = request.password unless request.password.nil?
+        query_params[downcase_first_letter('EncryptedPassword')] = request.encrypted_password unless request.encrypted_password.nil?
+        query_params[downcase_first_letter('DestFileName')] = request.dest_file_name unless request.dest_file_name.nil?
+        query_params[downcase_first_letter('RevisionAuthor')] = request.revision_author unless request.revision_author.nil?
+        query_params[downcase_first_letter('RevisionDateTime')] = request.revision_date_time unless request.revision_date_time.nil?
+
+        # header parameters
+        header_params = {}
+        # HTTP header 'Accept' (if needed)
+        header_params['Accept'] = @api_client.select_header_accept(['application/xml', 'application/json'])
+        # HTTP header 'Content-Type'
+        header_params['Content-Type'] = @api_client.select_header_content_type(['application/xml', 'application/json'])
+
+        # form parameters
+        form_params = {}
+
+        # http body (model)
+        post_body = nil
+        auth_names = ['JWT']
+
+        data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+                                                        header_params: header_params,
+                                                        query_params: query_params,
+                                                        form_params: form_params,
+                                                        body: post_body,
+                                                        auth_names: auth_names,
+                                                        return_type: 'WordsResponse')
+        if @api_client.config.debugging
+        @api_client.config.logger.debug "API called:
+        WordsApi#copy_styles_from_template\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        end
+
+        [data, status_code, headers]
+    end
+
     # Supported extensions: ".doc", ".docx", ".docm", ".dot", ".dotm", ".dotx", ".flatopc", ".fopc", ".flatopc_macro", ".fopc_macro", ".flatopc_template", ".fopc_template", ".flatopc_template_macro", ".fopc_template_macro", ".wordml", ".wml", ".rtf".
     # @param request CreateDocumentRequest
     # @return [DocumentResponse]

lib/aspose_words_cloud/api/words_api.rb

@@ -140,6 +140,9 @@ class EpubSaveOptionsData
     # Gets or sets a value indicating whether to write the roundtrip information when saving to HTML. The default value is true.
     attr_accessor :export_roundtrip_information
 
+    # Gets or sets the flag, that controls whether Aspose.Words.Drawing.Shape nodes are converted to SVG images when saving to HTML, MHTML or EPUB. Default value is false.
+    attr_accessor :export_shapes_as_svg
+
     # Gets or sets the flag, that controls how textboxes represented by Aspose.Words.Drawing.Shape are saved to HTML, MHTML or EPUB. The default value is false.
     # When set to true, exports textboxes as inline "svg" elements. When false, exports as "image" elements.
     attr_accessor :export_text_box_as_svg
@@ -268,6 +271,7 @@ def self.attribute_map
         :'export_page_setup' => :'ExportPageSetup',
         :'export_relative_font_size' => :'ExportRelativeFontSize',
         :'export_roundtrip_information' => :'ExportRoundtripInformation',
+        :'export_shapes_as_svg' => :'ExportShapesAsSvg',
         :'export_text_box_as_svg' => :'ExportTextBoxAsSvg',
         :'export_text_input_form_field_as_text' => :'ExportTextInputFormFieldAsText',
         :'export_toc_page_numbers' => :'ExportTocPageNumbers',
@@ -329,6 +333,7 @@ def self.swagger_types
         :'export_page_setup' => :'BOOLEAN',
         :'export_relative_font_size' => :'BOOLEAN',
         :'export_roundtrip_information' => :'BOOLEAN',
+        :'export_shapes_as_svg' => :'BOOLEAN',
         :'export_text_box_as_svg' => :'BOOLEAN',
         :'export_text_input_form_field_as_text' => :'BOOLEAN',
         :'export_toc_page_numbers' => :'BOOLEAN',
@@ -499,6 +504,10 @@ def initialize(attributes = {})
         self.export_roundtrip_information = attributes[:'ExportRoundtripInformation']
       end
 
+      if attributes.key?(:'ExportShapesAsSvg')
+        self.export_shapes_as_svg = attributes[:'ExportShapesAsSvg']
+      end
+
       if attributes.key?(:'ExportTextBoxAsSvg')
         self.export_text_box_as_svg = attributes[:'ExportTextBoxAsSvg']
       end
@@ -826,6 +835,7 @@ def ==(other)
           export_page_setup == other.export_page_setup &&
           export_relative_font_size == other.export_relative_font_size &&
           export_roundtrip_information == other.export_roundtrip_information &&
+          export_shapes_as_svg == other.export_shapes_as_svg &&
           export_text_box_as_svg == other.export_text_box_as_svg &&
           export_text_input_form_field_as_text == other.export_text_input_form_field_as_text &&
           export_toc_page_numbers == other.export_toc_page_numbers &&
@@ -858,7 +868,7 @@ def eql?(other)
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [allow_embedding_post_script_fonts, custom_time_zone_info_data, dml3_d_effects_rendering_mode, dml_effects_rendering_mode, dml_rendering_mode, file_name, flat_opc_xml_mapping_only, iml_rendering_mode, update_created_time_property, update_fields, update_last_printed_property, update_last_saved_time_property, update_sdt_content, zip_output, allow_negative_indent, css_class_name_prefix, css_style_sheet_file_name, css_style_sheet_type, document_split_criteria, document_split_heading_level, encoding, export_document_properties, export_drop_down_form_field_as_text, export_font_resources, export_fonts_as_base64, export_headers_footers_mode, export_images_as_base64, export_language_information, export_list_labels, export_original_url_for_linked_images, export_page_margins, export_page_setup, export_relative_font_size, export_roundtrip_information, export_text_box_as_svg, export_text_input_form_field_as_text, export_toc_page_numbers, export_xhtml_transitional, font_resources_subsetting_size_threshold, fonts_folder, fonts_folder_alias, html_version, image_resolution, images_folder, images_folder_alias, metafile_format, office_math_output_mode, pretty_format, resolve_font_names, resource_folder, resource_folder_alias, scale_image_to_shape_size, table_width_output_mode, epub_navigation_map_level, save_format].hash
+      [allow_embedding_post_script_fonts, custom_time_zone_info_data, dml3_d_effects_rendering_mode, dml_effects_rendering_mode, dml_rendering_mode, file_name, flat_opc_xml_mapping_only, iml_rendering_mode, update_created_time_property, update_fields, update_last_printed_property, update_last_saved_time_property, update_sdt_content, zip_output, allow_negative_indent, css_class_name_prefix, css_style_sheet_file_name, css_style_sheet_type, document_split_criteria, document_split_heading_level, encoding, export_document_properties, export_drop_down_form_field_as_text, export_font_resources, export_fonts_as_base64, export_headers_footers_mode, export_images_as_base64, export_language_information, export_list_labels, export_original_url_for_linked_images, export_page_margins, export_page_setup, export_relative_font_size, export_roundtrip_information, export_shapes_as_svg, export_text_box_as_svg, export_text_input_form_field_as_text, export_toc_page_numbers, export_xhtml_transitional, font_resources_subsetting_size_threshold, fonts_folder, fonts_folder_alias, html_version, image_resolution, images_folder, images_folder_alias, metafile_format, office_math_output_mode, pretty_format, resolve_font_names, resource_folder, resource_folder_alias, scale_image_to_shape_size, table_width_output_mode, epub_navigation_map_level, save_format].hash
     end
 
     # Builds the object from hash

lib/aspose_words_cloud/models/epub_save_options_data.rb

@@ -140,6 +140,9 @@ class HtmlSaveOptionsData
     # Gets or sets a value indicating whether to write the roundtrip information when saving to HTML. The default value is true.
     attr_accessor :export_roundtrip_information
 
+    # Gets or sets the flag, that controls whether Aspose.Words.Drawing.Shape nodes are converted to SVG images when saving to HTML, MHTML or EPUB. Default value is false.
+    attr_accessor :export_shapes_as_svg
+
     # Gets or sets the flag, that controls how textboxes represented by Aspose.Words.Drawing.Shape are saved to HTML, MHTML or EPUB. The default value is false.
     # When set to true, exports textboxes as inline "svg" elements. When false, exports as "image" elements.
     attr_accessor :export_text_box_as_svg
@@ -265,6 +268,7 @@ def self.attribute_map
         :'export_page_setup' => :'ExportPageSetup',
         :'export_relative_font_size' => :'ExportRelativeFontSize',
         :'export_roundtrip_information' => :'ExportRoundtripInformation',
+        :'export_shapes_as_svg' => :'ExportShapesAsSvg',
         :'export_text_box_as_svg' => :'ExportTextBoxAsSvg',
         :'export_text_input_form_field_as_text' => :'ExportTextInputFormFieldAsText',
         :'export_toc_page_numbers' => :'ExportTocPageNumbers',
@@ -325,6 +329,7 @@ def self.swagger_types
         :'export_page_setup' => :'BOOLEAN',
         :'export_relative_font_size' => :'BOOLEAN',
         :'export_roundtrip_information' => :'BOOLEAN',
+        :'export_shapes_as_svg' => :'BOOLEAN',
         :'export_text_box_as_svg' => :'BOOLEAN',
         :'export_text_input_form_field_as_text' => :'BOOLEAN',
         :'export_toc_page_numbers' => :'BOOLEAN',
@@ -494,6 +499,10 @@ def initialize(attributes = {})
         self.export_roundtrip_information = attributes[:'ExportRoundtripInformation']
       end
 
+      if attributes.key?(:'ExportShapesAsSvg')
+        self.export_shapes_as_svg = attributes[:'ExportShapesAsSvg']
+      end
+
       if attributes.key?(:'ExportTextBoxAsSvg')
         self.export_text_box_as_svg = attributes[:'ExportTextBoxAsSvg']
       end
@@ -817,6 +826,7 @@ def ==(other)
           export_page_setup == other.export_page_setup &&
           export_relative_font_size == other.export_relative_font_size &&
           export_roundtrip_information == other.export_roundtrip_information &&
+          export_shapes_as_svg == other.export_shapes_as_svg &&
           export_text_box_as_svg == other.export_text_box_as_svg &&
           export_text_input_form_field_as_text == other.export_text_input_form_field_as_text &&
           export_toc_page_numbers == other.export_toc_page_numbers &&
@@ -848,7 +858,7 @@ def eql?(other)
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [allow_embedding_post_script_fonts, custom_time_zone_info_data, dml3_d_effects_rendering_mode, dml_effects_rendering_mode, dml_rendering_mode, file_name, flat_opc_xml_mapping_only, iml_rendering_mode, update_created_time_property, update_fields, update_last_printed_property, update_last_saved_time_property, update_sdt_content, zip_output, allow_negative_indent, css_class_name_prefix, css_style_sheet_file_name, css_style_sheet_type, document_split_criteria, document_split_heading_level, encoding, export_document_properties, export_drop_down_form_field_as_text, export_font_resources, export_fonts_as_base64, export_headers_footers_mode, export_images_as_base64, export_language_information, export_list_labels, export_original_url_for_linked_images, export_page_margins, export_page_setup, export_relative_font_size, export_roundtrip_information, export_text_box_as_svg, export_text_input_form_field_as_text, export_toc_page_numbers, export_xhtml_transitional, font_resources_subsetting_size_threshold, fonts_folder, fonts_folder_alias, html_version, image_resolution, images_folder, images_folder_alias, metafile_format, office_math_output_mode, pretty_format, resolve_font_names, resource_folder, resource_folder_alias, save_format, scale_image_to_shape_size, table_width_output_mode].hash
+      [allow_embedding_post_script_fonts, custom_time_zone_info_data, dml3_d_effects_rendering_mode, dml_effects_rendering_mode, dml_rendering_mode, file_name, flat_opc_xml_mapping_only, iml_rendering_mode, update_created_time_property, update_fields, update_last_printed_property, update_last_saved_time_property, update_sdt_content, zip_output, allow_negative_indent, css_class_name_prefix, css_style_sheet_file_name, css_style_sheet_type, document_split_criteria, document_split_heading_level, encoding, export_document_properties, export_drop_down_form_field_as_text, export_font_resources, export_fonts_as_base64, export_headers_footers_mode, export_images_as_base64, export_language_information, export_list_labels, export_original_url_for_linked_images, export_page_margins, export_page_setup, export_relative_font_size, export_roundtrip_information, export_shapes_as_svg, export_text_box_as_svg, export_text_input_form_field_as_text, export_toc_page_numbers, export_xhtml_transitional, font_resources_subsetting_size_threshold, fonts_folder, fonts_folder_alias, html_version, image_resolution, images_folder, images_folder_alias, metafile_format, office_math_output_mode, pretty_format, resolve_font_names, resource_folder, resource_folder_alias, save_format, scale_image_to_shape_size, table_width_output_mode].hash
     end
 
     # Builds the object from hash