rubyXL 1.2.10 → 3.4.33

data/lib/rubyXL/convenience_methods.rb

@@ -0,0 +1,5 @@
+require 'rubyXL/convenience_methods/workbook'
+require 'rubyXL/convenience_methods/worksheet'
+require 'rubyXL/convenience_methods/cell'
+require 'rubyXL/convenience_methods/font'
+require 'rubyXL/convenience_methods/color'

data/lib/rubyXL/objects/border.rb

@@ -0,0 +1,71 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/simple_types'
+
+module RubyXL
+  class BorderEdge < OOXMLObject
+    define_attribute(:style, RubyXL::ST_BorderStyle, :default => 'none')
+    define_child_node(RubyXL::Color)
+
+    def set_rgb_color(font_color)
+      self.color = RubyXL::Color.new(:rgb => font_color.to_s)
+    end
+
+    def get_rgb_color
+      color && color.rgb
+    end
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_border-2.html
+  class Border < OOXMLObject
+    define_attribute(:diagonalUp,   :bool)
+    define_attribute(:diagonalDown, :bool)
+    define_attribute(:outline,      :bool, :default => true)
+    define_child_node(RubyXL::BorderEdge, :node_name => :left)
+    define_child_node(RubyXL::BorderEdge, :node_name => :right)
+    define_child_node(RubyXL::BorderEdge, :node_name => :top)
+    define_child_node(RubyXL::BorderEdge, :node_name => :bottom)
+    define_child_node(RubyXL::BorderEdge, :node_name => :diagonal)
+    define_child_node(RubyXL::BorderEdge, :node_name => :vertical)
+    define_child_node(RubyXL::BorderEdge, :node_name => :horizontal)
+    define_element_name 'border'
+
+    def get_edge_style(direction)
+      edge = self.send(direction)
+      edge && edge.style
+    end
+
+    def set_edge_style(direction, style)
+      edge = self.send(direction)
+      if edge
+        edge.style = style
+      else
+        self.send("#{direction}=", RubyXL::BorderEdge.new(:style => style))
+      end
+    end
+
+    def get_edge_color(direction)
+      edge = self.send(direction)
+      edge && edge.get_rgb_color
+    end
+
+    def set_edge_color(direction, color)
+      edge = self.send(direction)
+      if edge
+        edge.set_rgb_color(color)
+      else
+        self.send("#{direction}=", RubyXL::BorderEdge.new)
+        self.send(direction).set_rgb_color(color)
+      end
+    end
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_borders-1.html
+  class Borders < OOXMLContainerObject
+    define_child_node(RubyXL::Border, :collection => :with_count)
+    define_element_name 'borders'
+
+    def self.default
+      self.new(:_ => [ RubyXL::Border.new ])
+    end
+  end
+end

data/lib/rubyXL/objects/calculation_chain.rb

@@ -0,0 +1,31 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/extensions'
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_c-1.html
+  class CalculationChainCell < OOXMLObject
+    define_attribute(:r, :ref,  :accessor => :ref)
+    define_attribute(:i, :int,  :accessor => :sheet_id,    :default => 0)
+    define_attribute(:s, :bool, :accessor => :child_chain, :default => false)
+    define_attribute(:l, :bool, :accessor => :new_dep_lvl, :default => false)
+    define_attribute(:t, :bool, :accessor => :new_thread,  :default => false)
+    define_attribute(:a, :bool, :accessor => :array,       :default => false)
+    define_element_name 'c'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_calcChain.html
+  class CalculationChain < OOXMLTopLevelObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.calcChain+xml'.freeze
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/calcChain'.freeze
+
+    define_child_node(RubyXL::CalculationChainCell, :collection => true, :accessor => :cells)
+    define_child_node(RubyXL::ExtensionStorageArea)
+
+    define_element_name 'calcChain'
+    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main' => nil)
+
+    def xlsx_path
+      ROOT.join('xl', 'calcChain.xml')
+    end
+  end
+end

data/lib/rubyXL/objects/cell_style.rb

@@ -0,0 +1,63 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/simple_types'
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_cellStyle-1.html
+  class CellStyle < OOXMLObject
+    define_attribute(:name,          :string)
+    define_attribute(:xfId,          :int, :required => true)
+    define_attribute(:builtinId,     :int)
+    define_attribute(:iLevel,        :int)
+    define_attribute(:hidden,        :bool)
+    define_attribute(:customBuiltin, :bool)
+    define_element_name 'cellStyle'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_alignment-1.html
+  class Alignment < OOXMLObject
+    define_attribute(:horizontal,      RubyXL::ST_HorizontalAlignment)
+    define_attribute(:vertical,        RubyXL::ST_VerticalAlignment)
+    define_attribute(:textRotation,    :uint)
+    define_attribute(:wrapText,        :bool)
+    define_attribute(:indent,          :uint)
+    define_attribute(:relativeIndent,  :int)
+    define_attribute(:justifyLastLine, :bool)
+    define_attribute(:shrinkToFit,     :bool)
+    define_attribute(:readingOrder,    :uint)
+    define_element_name 'alignment'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_protection-1.html
+  class Protection < OOXMLObject
+    define_attribute(:locked, :bool)
+    define_attribute(:hidden, :bool)
+    define_element_name 'protection'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_xf-1.html
+  class XF < OOXMLObject
+    define_attribute(:numFmtId,          :int)
+    define_attribute(:fontId,            :int)
+    define_attribute(:fillId,            :int)
+    define_attribute(:borderId,          :int)
+    define_attribute(:xfId,              :int)
+    define_attribute(:quotePrefix,       :bool, :default => false)
+    define_attribute(:pivotButton,       :bool, :default => false)
+    define_attribute(:applyNumberFormat, :bool)
+    define_attribute(:applyFont,         :bool)
+    define_attribute(:applyFill,         :bool)
+    define_attribute(:applyBorder,       :bool)
+    define_attribute(:applyAlignment,    :bool)
+    define_attribute(:applyProtection,   :bool)
+    define_child_node(RubyXL::Alignment)
+    define_child_node(RubyXL::Protection)
+    define_element_name 'xf'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_numFmt-1.html
+  class NumFmt < OOXMLObject
+    define_attribute(:numFmtId,   :int,    :required => true)
+    define_attribute(:formatCode, :string, :required => true)
+    define_element_name 'numFmt'
+  end
+end

data/lib/rubyXL/objects/chartsheet.rb

@@ -0,0 +1,88 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/simple_types'
+require 'rubyXL/objects/extensions'
+require 'rubyXL/objects/relationships'
+require 'rubyXL/objects/sheet_common'
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_sheetProtection-4.html
+  class ChartsheetProtection < OOXMLObject
+    define_attribute(:password, RubyXL::ST_UnsignedShortHex)
+    define_attribute(:content,  :bool, :default => false)
+    define_attribute(:objects,  :bool, :default => false)
+    define_element_name 'sheetProtection'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_sheetPr-4.html
+  class ChartsheetProperties < OOXMLObject
+    define_attribute(:published,     :bool, :default => true)
+    define_attribute(:codeName,      :string)
+    define_child_node(RubyXL::Color, :node_name => :tabColor)
+    define_element_name 'sheetPr'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_pageSetup-5.html
+  class ChartsheetPageSetup < OOXMLObject
+    define_attribute(:paperSize,          :int,    :default => 1)
+    define_attribute(:firstPageNumber,    :int,    :default => 1)
+    define_attribute(:orientation,        RubyXL::ST_Orientation, :default => 'default')
+    define_attribute(:usePrinterDefaults, :bool,   :default => true)
+    define_attribute(:blackAndWhite,      :bool,   :default => false)
+    define_attribute(:draft,              :bool,   :default => false)
+    define_attribute(:useFirstPageNumber, :bool,   :default => false)
+    define_attribute(:horizontalDpi,      :int,    :default => 600)
+    define_attribute(:verticalDpi,        :int,    :default => 600)
+    define_attribute(:copies,             :int,    :default => 1)
+    define_relationship
+    define_element_name 'pageSetup'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_sheetView-2.html
+  class ChartsheetView < OOXMLObject
+    define_attribute(:tabSelected,    :bool,  :default => false)
+    define_attribute(:zoomScale,      :int,   :default => 100)
+    define_attribute(:workbookViewId, :int,   :required => true, :default => 0)
+    define_attribute(:zoomToFit,      :bool,  :default => false)
+    define_child_node(RubyXL::ExtensionStorageArea)
+    define_element_name 'sheetView'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_sheetViews-4.html
+  class ChartsheetViews < OOXMLObject
+    define_child_node(RubyXL::ChartsheetView, :collection => true)
+    define_child_node(RubyXL::ExtensionStorageArea)
+    define_element_name 'sheetViews'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_chartsheet.html
+  class Chartsheet < OOXMLTopLevelObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.chartsheet+xml'.freeze
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartsheet'.freeze
+
+    include RubyXL::RelationshipSupport
+    define_relationship(RubyXL::DrawingFile)
+
+    attr_accessor :state, :rels, :workbook, :sheet_name, :sheet_id
+
+    define_child_node(RubyXL::ChartsheetProperties)
+    define_child_node(RubyXL::ChartsheetViews)
+    define_child_node(RubyXL::ChartsheetProtection)
+    define_child_node(RubyXL::CustomSheetViews)
+    define_child_node(RubyXL::PageMargins)
+    define_child_node(RubyXL::ChartsheetPageSetup)
+    define_child_node(RubyXL::HeaderFooterSettings)
+    define_child_node(RubyXL::RID, :node_name => :drawing)
+    define_child_node(RubyXL::RID, :node_name => :legacyDrawing)
+    define_child_node(RubyXL::RID, :node_name => :legacyDrawingHF)
+    define_child_node(RubyXL::RID, :node_name => :picture)
+    define_child_node(RubyXL::WebPublishingItems)
+    define_child_node(RubyXL::ExtensionStorageArea)
+    define_element_name 'chartsheet'
+    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main'           => nil,
+                   'http://schemas.openxmlformats.org/officeDocument/2006/relationships' => 'r')
+
+    def xlsx_path
+      ROOT.join('xl', 'chartsheets', "sheet#{file_index}.xml")
+    end
+  end
+end

data/lib/rubyXL/objects/color.rb

@@ -0,0 +1,25 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/simple_types'
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_color-4.html
+  class Color < OOXMLObject
+    COLOR_REGEXP = /\A(?:[a-f0-9]{6}|[a-f0-9]{8})\Z/i
+
+    define_attribute(:auto,    :bool)
+    define_attribute(:indexed, :uint)
+    define_attribute(:rgb,     RubyXL::ST_UnsignedIntHex)
+    define_attribute(:theme,   :uint)
+    define_attribute(:tint,    :double, :default => 0.0)
+    define_element_name 'color'
+
+    # validates hex color code, no '#' allowed
+    def self.validate_color(color)
+      if color =~ COLOR_REGEXP
+        return true
+      else
+        raise 'invalid color'
+      end
+    end
+  end
+end

data/lib/rubyXL/objects/column_range.rb

@@ -0,0 +1,93 @@
+require 'rubyXL/objects/ooxml_object'
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_col-1.html
+  class ColumnRange < OOXMLObject
+    define_attribute(:min,          :uint, :required => true)
+    define_attribute(:max,          :uint, :required => true)
+    define_attribute(:width,        :double)
+    define_attribute(:style,        :uint, :default => 0, :accessor => :style_index)
+    define_attribute(:hidden,       :bool, :default => false)
+    define_attribute(:bestFit,      :bool, :default => false)
+    define_attribute(:customWidth,  :bool, :default => false)
+    define_attribute(:phonetic,     :bool, :default => false)
+    define_attribute(:outlineLevel, :int,  :default => 0)
+    define_attribute(:collapsed,    :bool, :default => false)
+    define_element_name 'col'
+
+    def delete_column(col_index)
+      col = col_index + 1
+      self.min -= 1 if min >= col
+      self.max -= 1 if max >= col
+    end
+
+    def insert_column(col_index)
+      col = col_index + 1
+      self.min += 1 if min >= col
+      self.max += 1 if max >= col - 1
+    end
+
+    def include?(col_index)
+      ((min - 1)..(max - 1)).include?(col_index)
+    end
+
+    def self.chars2raw(width_in_chars)
+      ((width_in_chars + (5.0 / RubyXL::Font::MAX_DIGIT_WIDTH)) * 256).to_i / 256.0
+    end
+
+    DEFAULT_WIDTH = 8
+  end
+
+  class ColumnRanges < OOXMLContainerObject
+    define_child_node(RubyXL::ColumnRange, :collection => true)
+
+    define_element_name 'cols'
+
+    # Locate an existing column range, make a new one if not found,
+    # or split existing column range into multiples.
+    def get_range(col_index)
+      col_num = col_index + 1
+
+      old_range = self.locate_range(col_index)
+
+      if old_range.nil? then
+        new_range = RubyXL::ColumnRange.new(width: RubyXL::ColumnRange.chars2raw(RubyXL::ColumnRange::DEFAULT_WIDTH))
+      else
+        if old_range.min == col_num && old_range.max == col_num then
+          return old_range # Single column range, OK to change in place
+        elsif old_range.min == col_num then
+          new_range = old_range.dup
+          old_range.min += 1
+        elsif old_range.max == col_num then
+          new_range = old_range.dup
+          old_range.max -= 1
+        else
+          prior_range = old_range.dup
+          prior_range.max = col_index # col_num - 1
+          self << prior_range
+
+          old_range.min = col_num + 1
+
+          new_range = RubyXL::ColumnRange.new
+        end
+      end
+
+      new_range.min = new_range.max = col_num
+      self << new_range
+      return new_range
+    end
+
+    def locate_range(col_index)
+      self.find { |range| range.include?(col_index) }
+    end
+
+    def insert_column(col_index)
+      self.each { |range| range.insert_column(col_index) }
+    end
+
+    def before_write_xml
+      self.sort_by!(&:min)
+      !self.empty?
+    end
+  end
+end

data/lib/rubyXL/objects/comments.rb

@@ -0,0 +1,44 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/extensions'
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_comment-1.html
+  class Comment < OOXMLObject
+    define_child_node(RubyXL::RichText, :node_name => 'text')
+    define_child_node(RubyXL::AlternateContent)
+    define_attribute(:ref,      :ref, :required => true)
+    define_attribute(:authorId, :int, :required => true)
+    define_attribute(:guid,     :string)
+    define_element_name 'comment'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_authors-1.html
+  class CommentList < OOXMLContainerObject
+    define_child_node(RubyXL::Comment, :collection => [0..-1])
+    define_element_name 'commentList'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_authors-1.html
+  class Authors < OOXMLContainerObject
+    define_child_node(RubyXL::StringNode, :node_name => :author, :collection => [0..-1])
+    define_element_name 'authors'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_comments.html
+  class CommentsFile < OOXMLTopLevelObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml'
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments'.freeze
+
+    define_child_node(RubyXL::Authors)
+    define_child_node(RubyXL::CommentList)
+    define_child_node(RubyXL::ExtensionStorageArea)
+    define_element_name 'comments'
+    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main' => nil)
+
+    attr_accessor :workbook
+
+    def xlsx_path
+      ROOT.join('xl', "comments#{file_index}.xml")
+    end
+  end
+end

data/lib/rubyXL/objects/connection.rb

@@ -0,0 +1,175 @@
+require 'rubyXL/objects/ooxml_object'
+require 'rubyXL/objects/simple_types'
+require 'rubyXL/objects/extensions'
+
+# Connections
+# https://msdn.microsoft.com/en-us/library/dd908547(v=office.12).aspx
+# http://www.datypic.com/sc/ooxml/s-sml-externalConnections.xsd.html
+
+module RubyXL
+  # http://www.datypic.com/sc/ooxml/e-ssml_dbPr-1.html
+  class OdbcOleDbProperties < OOXMLObject
+    define_attribute(:connection,    RubyXL::ST_Xstring, :required => true)
+    define_attribute(:command,       RubyXL::ST_Xstring)
+    define_attribute(:serverCommand, RubyXL::ST_Xstring)
+    define_attribute(:commandType,   :uint, :default => 2)
+
+    define_element_name 'dbPr'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_olapPr-1.html
+  class OlapProperties < OOXMLObject
+    define_attribute(:local,              :bool, :default => false)
+    define_attribute(:localConnection,    RubyXL::ST_Xstring)
+    define_attribute(:localRefresh,       :bool, :default => true)
+    define_attribute(:sendLocale,         :bool, :default => false)
+    define_attribute(:rowDrillCount,      :uint)
+    define_attribute(:serverFill,         :bool, :default => true)
+    define_attribute(:serverNumberFormat, :bool, :default => true)
+    define_attribute(:serverFont,         :bool, :default => true)
+    define_attribute(:serverFontColor,    :bool, :default => true)
+
+    define_element_name 'olapPr'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_s-1.html
+  # TODO: ssml:m & ssml:x... but how?
+  class ConnectionTable < OOXMLObject
+    define_attribute(:v, RubyXL::ST_Xstring, :required => true)
+
+    define_element_name 's'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_tables-1.html
+  class ConnectionTables < OOXMLObject
+    define_child_node(RubyXL::ConnectionTable, :collection => :with_count, :accessor => :tables, :node_name => :table)
+    define_element_name 'tables'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_webPr-1.html
+  class WebQueryProperties < OOXMLObject
+    define_attribute(:xml,         :bool, :default => false)
+    define_attribute(:sourceData,  :bool, :default => false)
+    define_attribute(:parsePre,    :bool, :default => false)
+    define_attribute(:consecutive, :bool, :default => false)
+    define_attribute(:firstRow,    :bool, :default => false)
+    define_attribute(:xl97,        :bool, :default => false)
+    define_attribute(:textDates,   :bool, :default => false)
+    define_attribute(:xl2000,      :bool, :default => false)
+    define_attribute(:url,         RubyXL::ST_Xstring)
+    define_attribute(:post,        RubyXL::ST_Xstring)
+    define_attribute(:htmlTables,  :bool, :default => false)
+    define_attribute(:htmlFormat,  ssml:ST_HtmlFmt, :default => 'none')
+    define_attribute(:editPage,    RubyXL::ST_Xstring)
+
+    define_child_node(RubyXL::ConnectionTables)
+
+    define_element_name 'webPr'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_textField-1.html
+  class ConnectionTextField < OOXMLObject
+    define_attribute(:type, RubyXL::ST_ExternalConnectionType, :default => 'general')
+    define_attribute(:position, :uint, :default => 0)
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_textFields-1.html
+  class ConnectionTextFields < OOXMLObject
+    define_child_node(RubyXL::ConnectionTextField, :collection => :with_count, :accessor => :text_fields, :node_name => :textField)
+
+    define_element_name 'textFields'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_textPr-1.html
+  class TextImportSettings < OOXMLObject
+    define_attribute(:prompt, :bool, :default => true)
+    define_attribute(:fileType,    RubyXL::ST_FileType, :default => 'win')
+    define_attribute(:codePage,    :uint, :default => 1252)
+    define_attribute(:firstRow,    :uint, :default => 1)
+    define_attribute(:sourceFile,  RubyXL::ST_Xstring, :default => '')
+    define_attribute(:delimited,   :bool, :default => true)
+    define_attribute(:decimal,     RubyXL::ST_Xstring,  :default => '.')
+    define_attribute(:thousands,   RubyXL::ST_Xstring,  :default => ',')
+    define_attribute(:tab,         :bool, :default => true)
+    define_attribute(:space,       :bool, :default => false)
+    define_attribute(:comma,       :bool, :default => false)
+    define_attribute(:semicolon,   :bool, :default => false)
+    define_attribute(:consecutive, :bool, :default => false)
+    define_attribute(:qualifier,   ssml:ST_Qualifier, :default => 'doubleQuote')
+    define_attribute(:delimiter,   RubyXL::ST_Xstring)
+
+    define_child_node(RubyXL::ConnectionTextFields)
+
+    define_element_name 'textPr'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_parameter-1.html
+  class QueryParameter < OOXMLObject
+    define_attribute(:name,            RubyXL::ST_Xstring)
+    define_attribute(:sqlType,         :int, :default => 0)
+    define_attribute(:parameterType,   RubyXL::ST_ParameterType, :default => 'prompt')
+    define_attribute(:refreshOnChange, :bool, :default => false)
+    define_attribute(:prompt,          RubyXL::ST_Xstring)
+    define_attribute(:boolean,         :bool)
+    define_attribute(:double,          :double)
+    define_attribute(:integer,         :int)
+    define_attribute(:string,          RubyXL::ST_Xstring)
+    define_attribute(:cell,            RubyXL::ST_Xstring)
+    define_element_name 'parameter'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_parameters-1.html
+  class QueryParameters < OOXMLObject
+    define_child_node(RubyXL::QueryParameter, :collection => :with_count, :accessor => :parameters, :node_name => :parameter)
+    define_element_name 'parameters'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_connection-1.html
+  class Connection < OOXMLObject
+    define_attribute(:id,                    :uint, :required => true)
+    define_attribute(:sourceFile,            RubyXL::ST_Xstring)
+    define_attribute(:odcFile,               RubyXL::ST_Xstring)
+    define_attribute(:keepAlive,             :bool, :default => false)
+    define_attribute(:interval,              :uint, :default => 0)
+    define_attribute(:name,                  RubyXL::ST_Xstring)
+    define_attribute(:description,           RubyXL::ST_Xstring)
+    define_attribute(:type,                  :uint)
+    define_attribute(:reconnectionMethod,    :uint, :default => 1)
+    define_attribute(:refreshedVersion,      :uint, :required => true)
+    define_attribute(:minRefreshableVersion, :uint, :default => 0)
+    define_attribute(:savePassword,          :bool, :default => false)
+    define_attribute(:new,                   :bool, :default => false)
+    define_attribute(:deleted,               :bool, :default => false)
+    define_attribute(:onlyUseConnectionFile, :bool, :default => false)
+    define_attribute(:background,            :bool, :default => false)
+    define_attribute(:refreshOnLoad,         :bool, :default => false)
+    define_attribute(:saveData,              :bool, :default => false)
+    define_attribute(:credentials,           RubyXL::ST_CredMethod, :default => 'integrated')
+    define_attribute(:singleSignOnId,        RubyXL::ST_Xstring)
+
+    define_child_node(RubyXL::OdbcOleDbProperties)
+    define_child_node(RubyXL::OlapProperties)
+    define_child_node(RubyXL::WebQueryProperties)
+    define_child_node(RubyXL::TextImportSettings)
+    define_child_node(RubyXL::QueryParameters)
+    define_child_node(RubyXL::ExtensionStorageArea)
+
+    define_element_name 'connection'
+  end
+
+  # http://www.datypic.com/sc/ooxml/e-ssml_connections.html
+  class Connections < OOXMLTopLevelObject
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.connections+xml'.freeze
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/connections'.freeze
+
+    define_child_node(RubyXL::Connection, :collection => true, :accessor => :connections)
+
+    define_element_name 'connections'
+
+    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main' => nil)
+
+    def xlsx_path
+      ROOT.join('xl', 'connections.xml')
+    end
+  end
+end