aspose_cells_cloud 25.7.1 → 25.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 918fa02597cf4e8f7eaf95b8fc96df2ebc3e548fb47aa7ace69343814dded631
-  data.tar.gz: ab6f461f740e55814718c1d4a574254148e1e8c7f7ebb833d7b16d297d9f5281
+  metadata.gz: ae34e00b90c1ac64062f05a1c87343e5fe4968dc72074839e62ce120f41db733
+  data.tar.gz: fb22ed282b2624855acbbd075077aa272899fc3d7e2a7af380faabd7043500da
 SHA512:
-  metadata.gz: cffbafbfb94c4418619a2d901372214cb0de41588d883e97c3ff19bf55ace6eb0b6d18a15883c01f5286920cc393244b94b2e6dab832752e16a87b47412faa2d
-  data.tar.gz: 7f9e6d998dd7acd32df0cec33d38dfdbb37d8bd759d8b89182c19a186c27fbe430fa6ef89db99964afb5598f38584c2b7f9dd9f96eb5a0eb353a97c14fe7d111
+  metadata.gz: a60260acf92ee3aa3c99c47ae810d18bf1ba07a2c83419e278972c01909e84477de4c30751d6e3420a04a3e9d3801ca1535b5dfeb12165c8ae0ecfbb73a1307e
+  data.tar.gz: 285e5f378315657b6a98d75d425ad76b7963a8645f83c0b581ebb0ea9668c4f0b834feb1b6017d0f1f9278ce28f5fcf13ec1b3dd42a8764cc55ed4a1f6dfd097

data/README.md

@@ -1,4 +1,4 @@
-![](https://img.shields.io/badge/aspose.cells%20Cloud%20SDK-25.7-green?style=for-the-badge&logo=ruby) [![Product Page](https://img.shields.io/badge/Product-0288d1?style=for-the-badge&logo=Google-Chrome&logoColor=white)](https://products.aspose.cloud/cells/ruby/) [![Documentation](https://img.shields.io/badge/Documentation-388e3c?style=for-the-badge&logo=Hugo&logoColor=white)](https://docs.aspose.cloud/cells/) [![API Ref](https://img.shields.io/badge/Reference-f39c12?style=for-the-badge&logo=html5&logoColor=white)](https://reference.aspose.cloud/cells/) [![Examples](https://img.shields.io/badge/Examples-1565c0?style=for-the-badge&logo=Github&logoColor=white)](https://github.com/aspose-cells-cloud/aspose-cells-cloud-perl/tree/master/Examples) [![Blog](https://img.shields.io/badge/Blog-d32f2f?style=for-the-badge&logo=WordPress&logoColor=white)](https://blog.aspose.cloud/categories/aspose.cells-cloud-product-family/) [![Support](https://img.shields.io/badge/Support-7b1fa2?style=for-the-badge&logo=Discourse&logoColor=white)](https://forum.aspose.cloud/c/cells/7)  [![Gem](https://img.shields.io/gem/v/aspose_cells_cloud?style=for-the-badge)](https://rubygems.org/gems/aspose_cells_cloud) [![Gem](https://img.shields.io/gem/dt/aspose_cells_cloud?style=for-the-badge)](https://github.com/aspose-cells-cloud/aspose-cells-cloud-ruby/archive/refs/heads/master.zip) [![GitHub license](https://img.shields.io/github/license/aspose-cells-cloud/aspose-cells-cloud-ruby?style=for-the-badge)](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.7?style=for-the-badge)
+![](https://img.shields.io/badge/aspose.cells%20Cloud%20SDK-25.8-green?style=for-the-badge&logo=ruby) [![Product Page](https://img.shields.io/badge/Product-0288d1?style=for-the-badge&logo=Google-Chrome&logoColor=white)](https://products.aspose.cloud/cells/ruby/) [![Documentation](https://img.shields.io/badge/Documentation-388e3c?style=for-the-badge&logo=Hugo&logoColor=white)](https://docs.aspose.cloud/cells/) [![API Ref](https://img.shields.io/badge/Reference-f39c12?style=for-the-badge&logo=html5&logoColor=white)](https://reference.aspose.cloud/cells/) [![Examples](https://img.shields.io/badge/Examples-1565c0?style=for-the-badge&logo=Github&logoColor=white)](https://github.com/aspose-cells-cloud/aspose-cells-cloud-perl/tree/master/Examples) [![Blog](https://img.shields.io/badge/Blog-d32f2f?style=for-the-badge&logo=WordPress&logoColor=white)](https://blog.aspose.cloud/categories/aspose.cells-cloud-product-family/) [![Support](https://img.shields.io/badge/Support-7b1fa2?style=for-the-badge&logo=Discourse&logoColor=white)](https://forum.aspose.cloud/c/cells/7)  [![Gem](https://img.shields.io/gem/v/aspose_cells_cloud?style=for-the-badge)](https://rubygems.org/gems/aspose_cells_cloud) [![Gem](https://img.shields.io/gem/dt/aspose_cells_cloud?style=for-the-badge)](https://github.com/aspose-cells-cloud/aspose-cells-cloud-ruby/archive/refs/heads/master.zip) [![GitHub license](https://img.shields.io/github/license/aspose-cells-cloud/aspose-cells-cloud-ruby?style=for-the-badge)](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.8?style=for-the-badge)
 
 # Ruby package for Aspose.Cells Cloud
 
@@ -14,7 +14,7 @@ To begin with Aspose.Cells Cloud, here's what you need to do:
 - execute the following command to get the latest Gem package.
 
 ```console
-gem 'aspose_cells_cloud', '~> 20.10'
+gem 'aspose_cells_cloud', '~> 25.8'
 ```
 
 or install directly
@@ -30,13 +30,32 @@ require 'openssl'
 require 'bundler'
 require 'aspose_cells_cloud'
 
-@instance = AsposeCellsCloud::CellsApi.new(ENV['CellsCloudClientId'], ENV['CellsCloudClientSecret'])
-request = AsposeCellsCloud::PutConvertWorkbookRequest.new(:File=>{"EmployeeSalesSummary.xlsx" => ::File.open(File.expand_path("./EmployeeSalesSummary.xlsx"),"r") },:format=>"csv");
-response = @instance.put_convert_workbook(request);
+CellsCloudClientId = "...."  # get from https://dashboard.aspose.cloud/#/applications  -> Set ENV['CellsCloudClientId']
+CellsCloudClientSecret = "...."   # get from https://dashboard.aspose.cloud/#/applications -> Set ENV['CellsCloudClientSecret']
+
+@instance = AsposeCellsCloud::CellsApi.new(CellsCloudClientId, CellsCloudClientSecret)
+request = AsposeCellsCloud::ConvertSpreadsheetRequest.new(:Spreadsheet=>'EmployeeSalesSummary.xlsx',:format=>format);
+response = @instance.convert_spreadsheet(request);
 FileUtils.cp(response.path, 'EmployeeSalesSummary.csv')
 
 ```
 
+4. How to upload a file to cloud storage.
+
+```ruby
+require 'openssl'
+require 'bundler'
+require 'aspose_cells_cloud'
+
+CellsCloudClientId = "...."  # get from https://dashboard.aspose.cloud/#/applications  -> Set ENV['CellsCloudClientId']
+CellsCloudClientSecret = "...."   # get from https://dashboard.aspose.cloud/#/applications -> Set ENV['CellsCloudClientSecret']
+
+@instance = AsposeCellsCloud::CellsApi.new(CellsCloudClientId, CellsCloudClientSecret)
+request =   AsposeCellsCloud::UploadFileRequest.new(:UploadFiles=>"EmployeeSalesSummary.xlsx",:path=>"TestData/EmployeeSalesSummary.xlsx",:storageName=>'');
+@instance.upload_file(request);
+
+```
+
 ## Support file format
 
 |**Format**|**Description**|**Load**|**Save**|
@@ -97,15 +116,21 @@ FileUtils.cp(response.path, 'EmployeeSalesSummary.csv')
 - 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 v25.7.0
+## Feature & Enhancements in Version 25.8
 
 Full list of issues covering all changes in this release:
 
-|**Summary**| **Category** |
-| :- |:-------------|
-| Optimize operate scope options for extProcessingController.| Improvement  |
-| Add protect/unprotect spreadsheet APIs.| New Feature  |
-| Add convert worksheet/table/range to other formats.      | New Feature  |
+|**Summary**|**Category**|
+| :- | :- |
+| Support of Authorization in Aspose.Cells Cloud Docker Container | New Feature  |
+| New Feature: Aggregate cells by color in CalculateController. | New Feature  |
+| New Feature: Math Calculations in CalculateController. | New Feature  |
+| New Feature: Adding/Deleting/Renaming worksheet in ManagementController. | New Feature  |
+| New Feature: Adding/Deleting worksheet in ManagementController. | New Feature  |
+| New Feature: create spreadsheet in ManagementController. | New Feature  |
+| New feature: Redesign the data import into the Spreadsheet. | New Feature  |
+| New feature: Swap data ranges in the spreadsheet. | New Feature  |
+| Fix the code generator of the cells cloud SDK specification for the enum query parameter. | Bug  |
 
 ## Available SDKs
 

data/lib/aspose_cells_cloud/api/cells_api.rb

@@ -40,6 +40,22 @@ module AsposeCellsCloud
       @api_client.config.host = app_host
     end
 
+    # The Aggregate by Color API provides a convenient way to perform calculations on cells that share the same fill or font color. This API supports a range of aggregate operations, including count, sum, maximum value, minimum value, and average value, enabling you to analyze and summarize data based on color distinctions.
+
+    def aggregate_cells_by_color( aggregate_cells_by_color_request, opts = {})
+
+       data, _status_code, _headers = aggregate_cells_by_color_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # The Math Calculate API enables you to perform a variety of mathematical operations on a selected range of cells. You can add or subtract a specific number from all selected cells, as well as multiply or divide individual cells and entire columns. This API simplifies complex calculations and enhances data manipulation capabilities.
+
+    def math_calculate( math_calculate_request, opts = {})
+
+       data, _status_code, _headers = math_calculate_request.create_http_request(@api_client,opts )
+       return data
+    end
+
     # Get Access Token Result: The Cells Cloud Get Token API acts as a proxy service,
     # forwarding user requests to the Aspose Cloud authentication server and returning the resulting access token to the client.
 
@@ -273,6 +289,13 @@ module AsposeCellsCloud
        return data
     end
 
+
+    def import_data_into_spreadsheet( import_data_into_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = import_data_into_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
     # Get an asymmetric public key.
 
     def get_public_key( get_public_key_request, opts = {})
@@ -281,6 +304,54 @@ module AsposeCellsCloud
        return data
     end
 
+    # The Web API allows users to create a new spreadsheet with a specified name. Optionally, a template can be provided to initialize the spreadsheet with predefined content or formatting.
+
+    def create_spreadsheet( create_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = create_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # The Web API enables users to add a new worksheet to a workbook, specifying the worksheet's type, position, and name. This function provides flexibility in managing workbook structure by allowing detailed control over worksheet addition.
+
+    def add_worksheet_to_spreadsheet( add_worksheet_to_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = add_worksheet_to_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # The Web API endpoint allows users to delete a specified worksheet from a workbook. This function provides a straightforward way to manage workbook structure by removing unnecessary or redundant worksheets.
+
+    def delete_worksheet_from_spreadsheet( delete_worksheet_from_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = delete_worksheet_from_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # The Web API endpoint allows users to rename a specified worksheet within a workbook. This function provides a straightforward way to update worksheet names, enhancing workbook organization and readability.
+
+    def rename_worksheet_in_spreadsheet( rename_worksheet_in_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = rename_worksheet_in_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # The Web API endpoint allows users to move a specified worksheet within a workbook. This function provides a straightforward way to move a worksheet, enhancing workbook organization.
+
+    def move_worksheet_in_spreadsheet( move_worksheet_in_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = move_worksheet_in_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
+    # The Web API endpoint allows users to compress a spreadsheet to reduce its file size. This function provides a straightforward way to optimize the storage and performance of spreadsheets by applying a specified compression level.
+
+    def compress_spreadsheet( compress_spreadsheet_request, opts = {})
+
+       data, _status_code, _headers = compress_spreadsheet_request.create_http_request(@api_client,opts )
+       return data
+    end
+
     # Applies dual-layer password protection to Excel spreadsheets, supporting both open and modify passwords with encryption.
 
     def protect_spreadsheet( protect_spreadsheet_request, opts = {})
@@ -432,6 +503,14 @@ module AsposeCellsCloud
        return data
     end
 
+    # The Swap Ranges for Excel API provides a powerful tool to move any two columns, rows, ranges, or individual cells within an Excel file. This API allows users to re-arrange their tables quickly and efficiently, ensuring that the original data formatting is preserved and all existing formulas continue to function correctly. By leveraging this API, users can streamline their data manipulation tasks and maintain the integrity of their spreadsheets.
+
+    def sawp_range( sawp_range_request, opts = {})
+
+       data, _status_code, _headers = sawp_range_request.create_http_request(@api_client,opts )
+       return data
+    end
+
 
     def download_file( download_file_request, opts = {})
 

data/lib/aspose_cells_cloud/models/aggregate_result_by_color.rb

@@ -0,0 +1,294 @@
+=begin
+--------------------------------------------------------------------------------------------------------------------
+ <copyright company="Aspose" file="AggregateResultByColorrb.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 AggregateResultByColor
+        #            
+        attr_accessor :aggregate_operation
+        #            
+        attr_accessor :color_name
+        #            
+        attr_accessor :count
+        #            
+        attr_accessor :sum
+        #            
+        attr_accessor :max_value
+        #            
+        attr_accessor :min_value
+        #            
+        attr_accessor :average_value
+        #            
+        attr_accessor :value
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'aggregate_operation' => :'AggregateOperation',
+        :'color_name' => :'ColorName',
+        :'count' => :'Count',
+        :'sum' => :'Sum',
+        :'max_value' => :'MaxValue',
+        :'min_value' => :'MinValue',
+        :'average_value' => :'AverageValue',
+        :'value' => :'Value'
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        :'aggregate_operation' => :'String',
+        :'color_name' => :'String',
+        :'count' => :'Integer',
+        :'sum' => :'Float',
+        :'max_value' => :'Float',
+        :'min_value' => :'Float',
+        :'average_value' => :'Float',
+        :'value' => :'Float'
+      }
+    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?(:'AggregateOperation')
+          self.aggregate_operation = attributes[:'AggregateOperation']
+      end
+      if attributes.has_key?(:'ColorName')
+          self.color_name = attributes[:'ColorName']
+      end
+      if attributes.has_key?(:'Count')
+          self.count = attributes[:'Count']
+      end
+      if attributes.has_key?(:'Sum')
+          self.sum = attributes[:'Sum']
+      end
+      if attributes.has_key?(:'MaxValue')
+          self.max_value = attributes[:'MaxValue']
+      end
+      if attributes.has_key?(:'MinValue')
+          self.min_value = attributes[:'MinValue']
+      end
+      if attributes.has_key?(:'AverageValue')
+          self.average_value = attributes[:'AverageValue']
+      end
+      if attributes.has_key?(:'Value')
+          self.value = attributes[:'Value']
+      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 @aggregate_operation.nil?
+          invalid_properties.push("invalid value for 'aggregate_operation', aggregate_operation cannot be nil.")
+      end
+      if @color_name.nil?
+          invalid_properties.push("invalid value for 'color_name', color_name cannot be nil.")
+      end
+      if @count.nil?
+          invalid_properties.push("invalid value for 'count', count cannot be nil.")
+      end
+      if @sum.nil?
+          invalid_properties.push("invalid value for 'sum', sum cannot be nil.")
+      end
+      if @max_value.nil?
+          invalid_properties.push("invalid value for 'max_value', max_value cannot be nil.")
+      end
+      if @min_value.nil?
+          invalid_properties.push("invalid value for 'min_value', min_value cannot be nil.")
+      end
+      if @average_value.nil?
+          invalid_properties.push("invalid value for 'average_value', average_value cannot be nil.")
+      end
+      if @value.nil?
+          invalid_properties.push("invalid value for 'value', value 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 @aggregate_operation.nil?
+      return false if @color_name.nil?
+      return false if @count.nil?
+      return false if @sum.nil?
+      return false if @max_value.nil?
+      return false if @min_value.nil?
+      return false if @average_value.nil?
+      return false if @value.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 &&
+          aggregate_operation == o.aggregate_operation &&
+          color_name == o.color_name &&
+          count == o.count &&
+          sum == o.sum &&
+          max_value == o.max_value &&
+          min_value == o.min_value &&
+          average_value == o.average_value &&
+          value == o.value 
+          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
+      [ aggregate_operation , color_name , count , sum , max_value , min_value , average_value , value ].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