aspose_cells_cloud 25.2 → 25.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54cd9f20f4468515ff4161c51ebb4ab19ed6dde4106976f0f36a74eebf288663
-  data.tar.gz: f57061de70de9d82a629b33f2a0a0c0d163c976b2f06b8d072dbd00621345697
+  metadata.gz: 21bf7cbccb7ccfc0ff5a7e46fae0b3e1c414c873c12e194927a8a98fe3d7aeab
+  data.tar.gz: 364938295f42a277ee5755dc742af6a5bde976fc3fb3f602220c7d1f62637c8c
 SHA512:
-  metadata.gz: 12c2993c77e34483f5961dc28d3a46ff66c32f74bd05b020e3c052ceb29aad968f70ad25581312fdda67437d8e4d5473f82abdcf2cbdfbfe6ecd8de97bcabf62
-  data.tar.gz: 2d2e37746dd77f8e9da008b90fc3fff0f8a5996384c8736945ea570baf82bd5f4b1506935202d1d569d12f3fe2d82d3e8bb998bb72ff6b5586fba8a0210135b8
+  metadata.gz: 9d92eb299cd8cc2c8f1a171628c22642fb254f7986725ca07205b89beb6da07353360cf7118b855d9cca84e41f2a52b051dac338e02dfd1b6548c2ebfd785d7e
+  data.tar.gz: fd7ac8da0a0c588eb00ffc1a285d50837fc4a29530cd0c2b0283a19deacb5d2fb8bd05effab0264cac0fdb765a5bd8c3b87ba86a666dc0fc85f35f8e2c43d2ee

data/README.md

@@ -1,4 +1,4 @@
-![](https://img.shields.io/badge/REST%20API-v3.0-lightgrey) ![Gem](https://img.shields.io/gem/v/aspose_cells_cloud) ![Gem](https://img.shields.io/gem/dt/aspose_cells_cloud) [![GitHub license](https://img.shields.io/github/license/aspose-cells-cloud/aspose-cells-cloud-ruby)](https://github.com/aspose-cells-cloud/aspose-cells-cloud-ruby/blob/master/LICENSE) ![GitHub commits since latest release (by date)](https://img.shields.io/github/commits-since/aspose-cells-cloud/aspose-cells-cloud-ruby/25.2)
+![](https://img.shields.io/badge/REST%20API-v3.0-lightgrey) ![Gem](https://img.shields.io/gem/v/aspose_cells_cloud) ![Gem](https://img.shields.io/gem/dt/aspose_cells_cloud) [![GitHub license](https://img.shields.io/github/license/aspose-cells-cloud/aspose-cells-cloud-ruby)](https://github.com/aspose-cells-cloud/aspose-cells-cloud-ruby/blob/master/LICENSE) ![GitHub commits since latest release (by date)](https://img.shields.io/github/commits-since/aspose-cells-cloud/aspose-cells-cloud-ruby/25.3)
 
 Aspose.Cells Cloud for Ruby enables you to handle various aspects of Excel files, including cell data, styles, formulas, charts, pivot tables, data validation, comments, drawing objects, images, hyperlinks, and so on. Additionally, it supports operations such as splitting, merging, repairing, and converting to other compatible file formats.
 
@@ -19,17 +19,15 @@ Enhance your Ruby applications with the [Aspose.Cells Cloud](https://products.as
 - Import/Export: Facilitates importing data from various sources into spreadsheets and exporting spreadsheet data to other formats.
 - Security Management: Offers a range of security features like data encryption, access control, and permission management to safeguard the security and integrity of spreadsheet data.
 
-## Feature & Enhancements in Version 25.2
+## Feature & Enhancements in Version 25.3
 
 Full list of issues covering all changes in this release:
 
-- Support copying a range from one workbook to another workbook.
-- Add query parameters for image and print options to enhance the Get Worksheet API.
-- Added an API to count the number of Excel characters for cells cloud.
-- Added an API to count the number of Excel words for cells cloud.
-- Added an API to count the number of occurrences of a specified word in Excel for cells cloud
-- Add a new feature to support converting range to images.
-- Add a new feature to support converting worksheets to images
+- Optimized the properties of `SaveOptions` to enhance performance and flexibility.
+- Optimized the conversion method of `Workbook` for improved efficiency and reliability.
+- Developed a new API to retrieve a comprehensive list of all styles in a workbook.
+- Enhanced all save options to improve functionality and user experience.
+- Added a new API to insert images into cells, providing enhanced document customization capabilities.
 
 ## Support file format
 

data/lib/aspose_cells_cloud/api/cells_api.rb

@@ -40,6 +40,7 @@ module AsposeCellsCloud
       @api_client.config.host = app_host
     end
 
+    # Perform business analysis of data in Excel files.
 
     def post_analyze_excel( post_analyze_excel_request, opts = {})
 
@@ -47,6 +48,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve the description of auto filters from a worksheet.
 
     def get_worksheet_auto_filter( get_worksheet_auto_filter_request, opts = {})
 
@@ -150,6 +152,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Get autoshapes description in worksheet.
 
     def get_worksheet_autoshapes( get_worksheet_autoshapes_request, opts = {})
 
@@ -165,6 +168,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Batch converting files that meet specific matching conditions.
 
     def post_batch_convert( post_batch_convert_request, opts = {})
 
@@ -212,6 +216,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Clear cell area contents in the worksheet.
 
     def post_clear_contents( post_clear_contents_request, opts = {})
 
@@ -339,6 +344,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of worksheet columns.
 
     def get_worksheet_columns( get_worksheet_columns_request, opts = {})
 
@@ -426,6 +432,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of rows in the worksheet.
 
     def get_worksheet_rows( get_worksheet_rows_request, opts = {})
 
@@ -545,6 +552,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve chart area description in the worksheet.
 
     def get_chart_area( get_chart_area_request, opts = {})
 
@@ -568,6 +576,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of charts in the worksheet.
 
     def get_worksheet_charts( get_worksheet_charts_request, opts = {})
 
@@ -759,6 +768,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of conditional formattings in a worksheet.
 
     def get_worksheet_conditional_formattings( get_worksheet_conditional_formattings_request, opts = {})
 
@@ -830,6 +840,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve workbooks in various formats.
 
     def get_workbook( get_workbook_request, opts = {})
 
@@ -933,6 +944,14 @@ module AsposeCellsCloud
     end
 
 
+    def post_convert_workbook( post_convert_workbook_request, opts = {})
+
+       data, _status_code, _headers = post_convert_workbook_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # Export Excel internal elements or the workbook itself to various format files.
+
     def post_export( post_export_request, opts = {})
 
        data, _status_code, _headers = post_export_request.create_http_request(@api_client,opts )
@@ -1036,6 +1055,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of hyperlinks in the worksheet.
 
     def get_worksheet_hyperlinks( get_worksheet_hyperlinks_request, opts = {})
 
@@ -1083,6 +1103,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Assemble data files with template files to generate files in various formats.
 
     def post_assemble( post_assemble_request, opts = {})
 
@@ -1202,6 +1223,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of ListObjects in the worksheet.
 
     def get_worksheet_list_objects( get_worksheet_list_objects_request, opts = {})
 
@@ -1305,6 +1327,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of OLE objects in the worksheet.
 
     def get_worksheet_ole_objects( get_worksheet_ole_objects_request, opts = {})
 
@@ -1352,6 +1375,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of vertical page breaks in the worksheet.
 
     def get_vertical_page_breaks( get_vertical_page_breaks_request, opts = {})
 
@@ -1431,6 +1455,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve page setup description in the worksheet.
 
     def get_page_setup( get_page_setup_request, opts = {})
 
@@ -1502,6 +1527,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of pictures in the worksheet.
 
     def get_worksheet_pictures( get_worksheet_pictures_request, opts = {})
 
@@ -1525,6 +1551,14 @@ module AsposeCellsCloud
        return data
     end
 
+    # add new picture in the cells.
+
+    def add_picture_in_cell( add_picture_in_cell_request, opts = {})
+
+       data, _status_code, _headers = add_picture_in_cell_request.create_http_request(@api_client,opts )
+       return data
+    end
+
     # Update a picture by index in the worksheet.
 
     def post_worksheet_picture( post_worksheet_picture_request, opts = {})
@@ -1549,6 +1583,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of pivottables  in the worksheet.
 
     def get_worksheet_pivot_tables( get_worksheet_pivot_tables_request, opts = {})
 
@@ -1716,6 +1751,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of Excel file properties.
 
     def get_document_properties( get_document_properties_request, opts = {})
 
@@ -1755,6 +1791,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Excel file digital signature.
 
     def post_digital_signature( post_digital_signature_request, opts = {})
 
@@ -1834,6 +1871,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Copy content from the source range to the destination range in the worksheet.
 
     def post_worksheet_cells_ranges_copy( post_worksheet_cells_ranges_copy_request, opts = {})
 
@@ -1944,6 +1982,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of shapes in the worksheet.
 
     def get_worksheet_shapes( get_worksheet_shapes_request, opts = {})
 
@@ -2007,6 +2046,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of sparkline groups in the worksheet.
 
     def get_worksheet_sparkline_groups( get_worksheet_sparkline_groups_request, opts = {})
 
@@ -2140,6 +2180,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve the description of the default style for the workbook .
 
     def get_workbook_default_style( get_workbook_default_style_request, opts = {})
 
@@ -2331,6 +2372,15 @@ module AsposeCellsCloud
        return data
     end
 
+    # Get all style in the workbook.
+
+    def get_all_styles( get_all_styles_request, opts = {})
+
+       data, _status_code, _headers = get_all_styles_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # Retrieve the description of worksheets from a workbook.
 
     def get_worksheets( get_worksheets_request, opts = {})
 
@@ -2642,6 +2692,7 @@ module AsposeCellsCloud
        return data
     end
 
+    # Retrieve descriptions of validations in the worksheet.
 
     def get_worksheet_validations( get_worksheet_validations_request, opts = {})
 

data/lib/aspose_cells_cloud/models/chart_points.rb

@@ -31,7 +31,7 @@ require 'date'
 module AsposeCellsCloud
 
   class ChartPoints
-        #            
+        #This class has a property named ChartPointList of type List ChartPoint  with an XmlElement attribute "ChartPoint".            
         attr_accessor :chart_point_list
         #            
         attr_accessor :link

data/lib/aspose_cells_cloud/models/charts.rb

@@ -31,7 +31,7 @@ require 'date'
 module AsposeCellsCloud
 
   class Charts
-        #            
+        #A property named ChartList of type List LinkElement  that is publicly accessible with both read and write capabilities.            
         attr_accessor :chart_list
         #            
         attr_accessor :link

data/lib/aspose_cells_cloud/models/convert_workbook_options.rb

@@ -0,0 +1,282 @@
+=begin
+--------------------------------------------------------------------------------------------------------------------
+ <copyright company="Aspose" file="ConvertWorkbookOptionsrb.cs">
+   Copyright (c) 2025 Aspose.Cells Cloud
+ </copyright>
+ <summary>
+   Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+ </summary>
+--------------------------------------------------------------------------------------------------------------------
+=end
+
+
+require 'date'
+
+module AsposeCellsCloud
+
+  class ConvertWorkbookOptions
+        #The class has a public property named "Name" with a getter and setter method.            
+        attr_accessor :name
+        #            
+        attr_accessor :data_source
+        #            
+        attr_accessor :file_info
+        #            
+        attr_accessor :page_setup
+        #            
+        attr_accessor :save_options
+        #            
+        attr_accessor :convert_format
+        #            
+        attr_accessor :check_excel_restriction
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'name' => :'Name',
+        :'data_source' => :'DataSource',
+        :'file_info' => :'FileInfo',
+        :'page_setup' => :'PageSetup',
+        :'save_options' => :'SaveOptions',
+        :'convert_format' => :'ConvertFormat',
+        :'check_excel_restriction' => :'CheckExcelRestriction'
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        :'name' => :'String',
+        :'data_source' => :'DataSource',
+        :'file_info' => :'FileInfo',
+        :'page_setup' => :'PageSetup',
+        :'save_options' => :'SaveOptions',
+        :'convert_format' => :'String',
+        :'check_excel_restriction' => :'BOOLEAN'
+      }
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.each_with_object({}){|(k,v), h| h[k.to_sym] = v}
+
+      if attributes.has_key?(:'Name')
+          self.name = attributes[:'Name']
+      end
+      if attributes.has_key?(:'DataSource')
+          self.data_source = attributes[:'DataSource']
+      end
+      if attributes.has_key?(:'FileInfo')
+          self.file_info = attributes[:'FileInfo']
+      end
+      if attributes.has_key?(:'PageSetup')
+          self.page_setup = attributes[:'PageSetup']
+      end
+      if attributes.has_key?(:'SaveOptions')
+          self.save_options = attributes[:'SaveOptions']
+      end
+      if attributes.has_key?(:'ConvertFormat')
+          self.convert_format = attributes[:'ConvertFormat']
+      end
+      if attributes.has_key?(:'CheckExcelRestriction')
+          self.check_excel_restriction = attributes[:'CheckExcelRestriction']
+      end
+
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properies with the reasons
+    def list_invalid_properties
+      invalid_properties = Array.new
+      if @name.nil?
+          invalid_properties.push("invalid value for 'name', name cannot be nil.")
+      end
+      if @data_source.nil?
+          invalid_properties.push("invalid value for 'data_source', data_source cannot be nil.")
+      end
+      if @file_info.nil?
+          invalid_properties.push("invalid value for 'file_info', file_info cannot be nil.")
+      end
+      if @page_setup.nil?
+          invalid_properties.push("invalid value for 'page_setup', page_setup cannot be nil.")
+      end
+      if @save_options.nil?
+          invalid_properties.push("invalid value for 'save_options', save_options cannot be nil.")
+      end
+      if @convert_format.nil?
+          invalid_properties.push("invalid value for 'convert_format', convert_format cannot be nil.")
+      end
+      if @check_excel_restriction.nil?
+          invalid_properties.push("invalid value for 'check_excel_restriction', check_excel_restriction cannot be nil.")
+      end
+
+      return invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      return false if @name.nil?
+      return false if @data_source.nil?
+      return false if @file_info.nil?
+      return false if @page_setup.nil?
+      return false if @save_options.nil?
+      return false if @convert_format.nil?
+      return false if @check_excel_restriction.nil?
+      return true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          name == o.name &&
+          data_source == o.data_source &&
+          file_info == o.file_info &&
+          page_setup == o.page_setup &&
+          save_options == o.save_options &&
+          convert_format == o.convert_format &&
+          check_excel_restriction == o.check_excel_restriction 
+          std_dev == o.std_dev
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [ name , data_source , file_info , page_setup , save_options , convert_format , check_excel_restriction ].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map{ |v| _deserialize($1, v) } )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
+        end # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def _deserialize(type, value)
+      case type.to_sym
+      when :DateTime
+        DateTime.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :BOOLEAN
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        temp_model = AsposeCellsCloud.const_get(type).new
+        temp_model.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        next if value.nil?
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map{ |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/aspose_cells_cloud/models/data_cleansing.rb

@@ -31,7 +31,7 @@ require 'date'
 module AsposeCellsCloud
 
   class DataCleansing
-        #            
+        #A property named "Ranges" of type IList Range with a default value of an empty List of Range objects.            
         attr_accessor :ranges
         #Represents whether the data needs to be populated.            
         attr_accessor :need_fill_data