aspose_cells_cloud 24.3 → 24.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aafed91fd5ad7d98ee6419cfba2ee2848b047fcdb51f54caa0b5af02a40e6848
-  data.tar.gz: c74e7fb34b6de9b7eef3ef31ad8c42acbf5a97207d239d6411919f319668ff8c
+  metadata.gz: 3bb70a08debd2ae25df9674a51c2df42427482c9b42a2569cdf78ac565cbbf3f
+  data.tar.gz: 5c4e6872336078e23af85fb57a991396dfc0ebb8f6bfc5d1dbda18b39c8ce93c
 SHA512:
-  metadata.gz: 04a1a41e6b5b55714df4d68b779ac2a525f4b531820300b2d87533dbe9dc897f3f1c373bc750170a74e1a9cab7d43921e92369d52d32b95a743fc8261e583adf
-  data.tar.gz: 879f04967f923f4e9410015739d5cd63fc894509a6581390f59012b91b62c2911159b425d570ed4daa948670dcce0d2a98194466248e1b2d61e66efd24c398b1
+  metadata.gz: 4f712212a26840f1e9516cf3f7d66a4398825463e9940334f3c81766474996c58d1bfe74dcfe674fd03ab1aa9822497beb89a8a4faee4a7ad3fcb14d0a6fadea
+  data.tar.gz: d86955c3d59d2b1d659ab87b2d3163ba86aab0c1203603a89b9f3a8469efe67ae5d61f2807498c3c02a72e92beebdfabb8456991de470d8aff0d3ff4cdc4241c

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/24.3)
+![](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/24.4)
 
 
 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.
@@ -23,14 +23,11 @@ Enhance your Ruby applications with the [Aspose.Cells Cloud](https://products.as
 
 
 
-## Feature & Enhancements in Version 24.3
+## Feature & Enhancements in Version 24.4
 
 Full list of issues covering all changes in this release:
 
-- Support data deduplication.
-- Support data filling.
-- Support to delete incomplete rows.
-- Support data cleansing.
+- Support data transformation.
 
 ## Support file format
 
@@ -129,6 +126,13 @@ request =   AsposeCellsCloud::PutConvertWorkbookRequest.new(:File=>mapFiles,:for
 
 # Release history version
 
+## Enhancements in Version 24.3
+
+- Support data deduplication.
+- Support data filling.
+- Support to delete incomplete rows.
+- Support data cleansing.
+
 ## Enhancements in Version 24.2.1
 
 - Support data deduplication.

data/lib/aspose_cells_cloud/api/cells_api.rb

@@ -1025,6 +1025,14 @@ module AsposeCellsCloud
        return data
     end
 
+    # Transform spreadsheet data is mainly used to pivot columns, unpivot columns.
+
+    def post_data_transformation( post_data_transformation_request, opts = {})
+
+       data, _status_code, _headers = post_data_transformation_request.create_http_request(@api_client,opts )
+       return data
+    end
+
     # Retrieve descriptions of hyperlinks in the worksheet.
 
     def get_worksheet_hyperlinks( get_worksheet_hyperlinks_request, opts = {})

data/lib/aspose_cells_cloud/models/cells_object_operate_task_parameter.rb

@@ -36,6 +36,8 @@ module AsposeCellsCloud
         #            
         attr_accessor :operate_parameter
         #            
+        attr_accessor :destinatio_data_source
+        #            
         attr_accessor :destination_workbook
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -43,6 +45,7 @@ module AsposeCellsCloud
       {
         :'operate_object' => :'OperateObject',
         :'operate_parameter' => :'OperateParameter',
+        :'destinatio_data_source' => :'DestinatioDataSource',
         :'destination_workbook' => :'DestinationWorkbook'
       }
     end
@@ -52,6 +55,7 @@ module AsposeCellsCloud
       {
         :'operate_object' => :'OperateObject',
         :'operate_parameter' => :'OperateParameter',
+        :'destinatio_data_source' => :'DataSource',
         :'destination_workbook' => :'FileSource'
       }
     end
@@ -70,6 +74,9 @@ module AsposeCellsCloud
       if attributes.has_key?(:'OperateParameter')
           self.operate_parameter = attributes[:'OperateParameter']
       end
+      if attributes.has_key?(:'DestinatioDataSource')
+          self.destinatio_data_source = attributes[:'DestinatioDataSource']
+      end
       if attributes.has_key?(:'DestinationWorkbook')
           self.destination_workbook = attributes[:'DestinationWorkbook']
       end
@@ -86,6 +93,9 @@ module AsposeCellsCloud
       if @operate_parameter.nil?
           invalid_properties.push("invalid value for 'operate_parameter', operate_parameter cannot be nil.")
       end
+      if @destinatio_data_source.nil?
+          invalid_properties.push("invalid value for 'destinatio_data_source', destinatio_data_source cannot be nil.")
+      end
       if @destination_workbook.nil?
           invalid_properties.push("invalid value for 'destination_workbook', destination_workbook cannot be nil.")
       end
@@ -98,6 +108,7 @@ module AsposeCellsCloud
     def valid?
       return false if @operate_object.nil?
       return false if @operate_parameter.nil?
+      return false if @destinatio_data_source.nil?
       return false if @destination_workbook.nil?
       return true
     end
@@ -109,6 +120,7 @@ module AsposeCellsCloud
       self.class == o.class &&
           operate_object == o.operate_object &&
           operate_parameter == o.operate_parameter &&
+          destinatio_data_source == o.destinatio_data_source &&
           destination_workbook == o.destination_workbook 
           std_dev == o.std_dev
     end
@@ -122,7 +134,7 @@ module AsposeCellsCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [ operate_object , operate_parameter , destination_workbook ].hash
+      [ operate_object , operate_parameter , destinatio_data_source , destination_workbook ].hash
     end
 
     # Builds the object from hash

data/lib/aspose_cells_cloud/models/convert_task_parameter.rb

@@ -31,6 +31,8 @@ require 'date'
 module AsposeCellsCloud
 
   class ConvertTaskParameter
+        #            
+        attr_accessor :data_source
         #            
         attr_accessor :workbook
         #            
@@ -43,6 +45,7 @@ module AsposeCellsCloud
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'data_source' => :'DataSource',
         :'workbook' => :'Workbook',
         :'destination_file' => :'DestinationFile',
         :'region' => :'Region',
@@ -53,6 +56,7 @@ module AsposeCellsCloud
     # Attribute type mapping.
     def self.swagger_types
       {
+        :'data_source' => :'DataSource',
         :'workbook' => :'FileSource',
         :'destination_file' => :'String',
         :'region' => :'String',
@@ -68,6 +72,9 @@ module AsposeCellsCloud
       # convert string to symbol for hash key
       attributes = attributes.each_with_object({}){|(k,v), h| h[k.to_sym] = v}
 
+      if attributes.has_key?(:'DataSource')
+          self.data_source = attributes[:'DataSource']
+      end
       if attributes.has_key?(:'Workbook')
           self.workbook = attributes[:'Workbook']
       end
@@ -87,6 +94,9 @@ module AsposeCellsCloud
     # @return Array for valid properies with the reasons
     def list_invalid_properties
       invalid_properties = Array.new
+      if @data_source.nil?
+          invalid_properties.push("invalid value for 'data_source', data_source cannot be nil.")
+      end
       if @workbook.nil?
           invalid_properties.push("invalid value for 'workbook', workbook cannot be nil.")
       end
@@ -106,6 +116,7 @@ module AsposeCellsCloud
     # 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 @data_source.nil?
       return false if @workbook.nil?
       return false if @destination_file.nil?
       return false if @region.nil?
@@ -118,6 +129,7 @@ module AsposeCellsCloud
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          data_source == o.data_source &&
           workbook == o.workbook &&
           destination_file == o.destination_file &&
           region == o.region &&
@@ -134,7 +146,7 @@ module AsposeCellsCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [ workbook , destination_file , region , save_options ].hash
+      [ data_source , workbook , destination_file , region , save_options ].hash
     end
 
     # Builds the object from hash

data/lib/aspose_cells_cloud/models/convert_worksheet_task_parameter.rb

@@ -31,11 +31,15 @@ require 'date'
 module AsposeCellsCloud
 
   class ConvertWorksheetTaskParameter
+        #            
+        attr_accessor :data_source
         #            
         attr_accessor :workbook
         #            
         attr_accessor :sheet
         #            
+        attr_accessor :target_data_source
+        #            
         attr_accessor :target
         #            
         attr_accessor :format
@@ -51,8 +55,10 @@ module AsposeCellsCloud
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'data_source' => :'DataSource',
         :'workbook' => :'Workbook',
         :'sheet' => :'Sheet',
+        :'target_data_source' => :'TargetDataSource',
         :'target' => :'Target',
         :'format' => :'Format',
         :'area' => :'Area',
@@ -65,8 +71,10 @@ module AsposeCellsCloud
     # Attribute type mapping.
     def self.swagger_types
       {
+        :'data_source' => :'DataSource',
         :'workbook' => :'FileSource',
         :'sheet' => :'String',
+        :'target_data_source' => :'DataSource',
         :'target' => :'FileSource',
         :'format' => :'String',
         :'area' => :'String',
@@ -84,12 +92,18 @@ module AsposeCellsCloud
       # convert string to symbol for hash key
       attributes = attributes.each_with_object({}){|(k,v), h| h[k.to_sym] = v}
 
+      if attributes.has_key?(:'DataSource')
+          self.data_source = attributes[:'DataSource']
+      end
       if attributes.has_key?(:'Workbook')
           self.workbook = attributes[:'Workbook']
       end
       if attributes.has_key?(:'Sheet')
           self.sheet = attributes[:'Sheet']
       end
+      if attributes.has_key?(:'TargetDataSource')
+          self.target_data_source = attributes[:'TargetDataSource']
+      end
       if attributes.has_key?(:'Target')
           self.target = attributes[:'Target']
       end
@@ -115,12 +129,18 @@ module AsposeCellsCloud
     # @return Array for valid properies with the reasons
     def list_invalid_properties
       invalid_properties = Array.new
+      if @data_source.nil?
+          invalid_properties.push("invalid value for 'data_source', data_source cannot be nil.")
+      end
       if @workbook.nil?
           invalid_properties.push("invalid value for 'workbook', workbook cannot be nil.")
       end
       if @sheet.nil?
           invalid_properties.push("invalid value for 'sheet', sheet cannot be nil.")
       end
+      if @target_data_source.nil?
+          invalid_properties.push("invalid value for 'target_data_source', target_data_source cannot be nil.")
+      end
       if @target.nil?
           invalid_properties.push("invalid value for 'target', target cannot be nil.")
       end
@@ -146,8 +166,10 @@ module AsposeCellsCloud
     # 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 @data_source.nil?
       return false if @workbook.nil?
       return false if @sheet.nil?
+      return false if @target_data_source.nil?
       return false if @target.nil?
       return false if @format.nil?
       return false if @area.nil?
@@ -162,8 +184,10 @@ module AsposeCellsCloud
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          data_source == o.data_source &&
           workbook == o.workbook &&
           sheet == o.sheet &&
+          target_data_source == o.target_data_source &&
           target == o.target &&
           format == o.format &&
           area == o.area &&
@@ -182,7 +206,7 @@ module AsposeCellsCloud
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [ workbook , sheet , target , format , area , page_index , vertical_resolution , horizontal_resolution ].hash
+      [ data_source , workbook , sheet , target_data_source , target , format , area , page_index , vertical_resolution , horizontal_resolution ].hash
     end
 
     # Builds the object from hash

data/lib/aspose_cells_cloud/models/data_item.rb

@@ -0,0 +1,222 @@
+=begin
+--------------------------------------------------------------------------------------------------------------------
+ <copyright company="Aspose" file="DataItemrb.cs">
+   Copyright (c) 2024 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 DataItem
+        #            
+        attr_accessor :data_item_type
+        #            
+        attr_accessor :value
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'data_item_type' => :'DataItemType',
+        :'value' => :'Value'
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        :'data_item_type' => :'String',
+        :'value' => :'String'
+      }
+    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?(:'DataItemType')
+          self.data_item_type = attributes[:'DataItemType']
+      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 @data_item_type.nil?
+          invalid_properties.push("invalid value for 'data_item_type', data_item_type 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 @data_item_type.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 &&
+          data_item_type == o.data_item_type &&
+          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
+      [ data_item_type , 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