diff --git a/.gitignore b/.gitignore deleted file mode 100644 index 1c2c1d5..0000000 --- a/.gitignore +++ /dev/null @@ -1,9 +0,0 @@ -/.bundle/ -/.yardoc -/Gemfile.lock -/_yardoc/ -/coverage/ -/doc/ -/pkg/ -/spec/reports/ -/tmp/ diff --git a/.rspec b/.rspec deleted file mode 100644 index 9dd03e0..0000000 --- a/.rspec +++ /dev/null @@ -1,2 +0,0 @@ ---format documentation ---color diff --git a/.vscode/launch.json b/.vscode/launch.json deleted file mode 100644 index 4b6a3f5..0000000 --- a/.vscode/launch.json +++ /dev/null @@ -1,61 +0,0 @@ -{ - "version": "0.2.0", - "configurations": [ - { - "name": "Debug Local File", - "type": "Ruby", - "request": "launch", - "cwd": "${workspaceRoot}", - "program": "${workspaceRoot}/main.rb" - }, - { - "name": "Listen for rdebug-ide", - "type": "Ruby", - "request": "attach", - "cwd": "${workspaceRoot}", - "remoteHost": "127.0.0.1", - "remotePort": "1234", - "remoteWorkspaceRoot": "${workspaceRoot}" - }, - { - "name": "Rails server", - "type": "Ruby", - "request": "launch", - "cwd": "${workspaceRoot}", - "program": "${workspaceRoot}/bin/rails", - "args": [ - "server" - ] - }, - { - "name": "RSpec - all", - "type": "Ruby", - "request": "launch", - "cwd": "${workspaceRoot}", - "program": "${workspaceRoot}/bin/rspec", - "args": [ - "-I", - "${workspaceRoot}" - ] - }, - { - "name": "RSpec - active spec file only", - "type": "Ruby", - "request": "launch", - "cwd": "${workspaceRoot}", - "program": "${workspaceRoot}/bin/rspec", - "args": [ - "-I", - "${workspaceRoot}", - "${file}" - ] - }, - { - "name": "Cucumber", - "type": "Ruby", - "request": "launch", - "cwd": "${workspaceRoot}", - "program": "${workspaceRoot}/bin/cucumber" - } - ] -} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json deleted file mode 100644 index c67846a..0000000 --- a/.vscode/settings.json +++ /dev/null @@ -1,4 +0,0 @@ -// Place your settings in this file to overwrite default and user settings. -{ - "editor.tabSize": 2 -} \ No newline at end of file diff --git a/Gemfile b/Gemfile deleted file mode 100644 index 133a0be..0000000 --- a/Gemfile +++ /dev/null @@ -1,4 +0,0 @@ -source 'https://rubygems.org' - -# Specify your gem's dependencies in txtextcontrol-reportingcloud.gemspec -gemspec diff --git a/LICENSE.md b/LICENSE.md deleted file mode 100644 index 8197eb2..0000000 --- a/LICENSE.md +++ /dev/null @@ -1,18 +0,0 @@ -## Copyright © 2019, Text Control GmbH. All rights reserved. - -Redistribution and use in source and binary forms, with or without modification, are permitted provided that the -following conditions are met: - -- Redistributions of source code must retain the above copyright notice, this list of conditions and the following - disclaimer. - -- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following - disclaimer in the documentation and/or other materials provided with the distribution. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, -INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, -WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF -THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/README.md b/README.md deleted file mode 100644 index b03a33b..0000000 --- a/README.md +++ /dev/null @@ -1,48 +0,0 @@ -![Logo](https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/resource/rc_logo_512.png) - -# ReportingCloud Ruby SDK - -[![Gem Version](https://badge.fury.io/rb/txtextcontrol-reportingcloud.svg)](https://badge.fury.io/rb/txtextcontrol-reportingcloud) - -This is the official Ruby SDK for the ReportingCloud Web API. It is authored, maintained and fully supported by [Text Control GmbH](http://www.textcontrol.com). - -[http://www.reporting.cloud](http://www.reporting.cloud) - -Before using ReportingCloud, please sign up to the service: - -[https://portal.reporting.cloud](https://portal.reporting.cloud) - -## Installation - -Add this line to your application's Gemfile: - -```ruby -gem 'txtextcontrol-reportingcloud' -``` - -And then execute: - - $ bundle - -Or install it yourself as: - - $ gem install txtextcontrol-reportingcloud - -## API documentation (YARD) - -All the source code in this library is documented using [YARD](http://yardoc.org/). - -You can read the [API documentation](https://textcontrol.github.io/txtextcontrol-reportingcloud-ruby/) online, or build it yourself, using the following command: - - $ yard doc - -The resultant set of HTML files will be written to `~/txtextcontrol-reportingcloud-ruby/doc`. - -If you don't have YARD already installed, you can install it with RubyGems with the following command: - - $ gem install yard - -## Contributing - -Bug reports and pull requests are welcome on GitHub at https://github.com/TextControl/txtextcontrol-reportingcloud-ruby. - diff --git a/Rakefile b/Rakefile deleted file mode 100644 index cb7386a..0000000 --- a/Rakefile +++ /dev/null @@ -1,6 +0,0 @@ -require "bundler/gem_tasks" -require "rspec/core/rake_task" - -RSpec::Core::RakeTask.new(:spec) - -task :default => :spec diff --git a/String.html b/String.html new file mode 100644 index 0000000..81250e6 --- /dev/null +++ b/String.html @@ -0,0 +1,258 @@ + + + + + + + Class: String + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: String + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/core_ext/string.rb
+
+ +
+ +

Overview

+
+ +

Extensions to class String.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + + + + + +

+ Instance Method Summary + collapse +

+ + + + + + +
+

Instance Method Details

+ + +
+

+ + #remove_first_and_lastString + + + + + +

+
+ +

Removes the first and last characters from a string and returns the +manipulated string.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    The string without its first and last characters.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+21
+22
+23
+24
+25
+26
+27
+
+
# File 'lib/core_ext/string.rb', line 21
+
+def remove_first_and_last 
+  if self.length == 0 then return '' end
+  result = self.dup
+  result[0] = ''
+  if result.length > 0 then result[result.length - 1] = '' end
+  return result
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl.html b/TXTextControl.html new file mode 100644 index 0000000..87eee05 --- /dev/null +++ b/TXTextControl.html @@ -0,0 +1,142 @@ + + + + + + + Module: TXTextControl + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Module: TXTextControl + + + +

+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud.rb,
+ lib/txtextcontrol/reportingcloud/api_key.rb,
lib/txtextcontrol/reportingcloud/version.rb,
lib/txtextcontrol/reportingcloud/template.rb,
lib/txtextcontrol/reportingcloud/merge_body.rb,
lib/txtextcontrol/reportingcloud/append_body.rb,
lib/txtextcontrol/reportingcloud/merge_block.rb,
lib/txtextcontrol/reportingcloud/merge_field.rb,
lib/txtextcontrol/reportingcloud/template_info.rb,
lib/txtextcontrol/reportingcloud/incorrect_word.rb,
lib/txtextcontrol/reportingcloud/merge_settings.rb,
lib/txtextcontrol/reportingcloud/reportingcloud.rb,
lib/txtextcontrol/reportingcloud/append_document.rb,
lib/txtextcontrol/reportingcloud/account_settings.rb,
lib/txtextcontrol/reportingcloud/document_settings.rb,
lib/txtextcontrol/reportingcloud/find_and_replace_body.rb,
lib/txtextcontrol/reportingcloud/template_data_validator.rb,
lib/txtextcontrol/reportingcloud/template_name_validator.rb
+
+
+ +
+ +

Overview

+
+ +

ReportingCloud Ruby SDK

+ +

Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and +fully supported by Text Control GmbH. (www.textcontrol.com).

+ +

Go to www.reporting.cloud to learn +more about ReportingCloud Go to github.com/TextControl/txtextcontrol-reportingcloud-ruby +for the canonical source repository.

+ +

License: raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md

+ +

Copyright: © 2019 Text Control GmbH

+ + +
+
+
+ + +

Defined Under Namespace

+

+ + + Modules: ReportingCloud + + + + +

+ + + + + + + + + +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud.html b/TXTextControl/ReportingCloud.html new file mode 100644 index 0000000..8f1efc7 --- /dev/null +++ b/TXTextControl/ReportingCloud.html @@ -0,0 +1,186 @@ + + + + + + + Module: TXTextControl::ReportingCloud + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Module: TXTextControl::ReportingCloud + + + +

+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud.rb,
+ lib/txtextcontrol/reportingcloud/api_key.rb,
lib/txtextcontrol/reportingcloud/version.rb,
lib/txtextcontrol/reportingcloud/template.rb,
lib/txtextcontrol/reportingcloud/merge_body.rb,
lib/txtextcontrol/reportingcloud/append_body.rb,
lib/txtextcontrol/reportingcloud/merge_block.rb,
lib/txtextcontrol/reportingcloud/merge_field.rb,
lib/txtextcontrol/reportingcloud/template_info.rb,
lib/txtextcontrol/reportingcloud/incorrect_word.rb,
lib/txtextcontrol/reportingcloud/merge_settings.rb,
lib/txtextcontrol/reportingcloud/reportingcloud.rb,
lib/txtextcontrol/reportingcloud/append_document.rb,
lib/txtextcontrol/reportingcloud/account_settings.rb,
lib/txtextcontrol/reportingcloud/document_settings.rb,
lib/txtextcontrol/reportingcloud/find_and_replace_body.rb,
lib/txtextcontrol/reportingcloud/template_data_validator.rb,
lib/txtextcontrol/reportingcloud/template_name_validator.rb
+
+
+ +
+ +

Overview

+
+ +

The ReportingCloud module.

+ + +
+
+
+ + +

Defined Under Namespace

+

+ + + + + Classes: APIKey, AccountSettings, AppendBody, AppendDocument, DocumentSettings, FindAndReplaceBody, IncorrectWord, MergeBlock, MergeBody, MergeField, MergeSettings, ReportingCloud, Template, TemplateDataValidator, TemplateInfo, TemplateNameValidator + + +

+ +

Constant Summary

+
+ +
DEFAULT_BASE_URI = +
+
+ +

Default API base url.

+ + +
+
+
+ + +
+
+
"https://api.reporting.cloud"
+ +
DEFAULT_VERSION = +
+
+ +

Default API version.

+ + +
+
+
+ + +
+
+
"v1"
+ +
DEFAULT_TIMEOUT = +
+
+ +

Default http request timeout in seconds.

+ + +
+
+
+ + +
+
+
10
+ +
VERSION = + +
+
"1.2.1"
+ +
+ + + + + + + + + +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/APIKey.html b/TXTextControl/ReportingCloud/APIKey.html new file mode 100644 index 0000000..d32b45c --- /dev/null +++ b/TXTextControl/ReportingCloud/APIKey.html @@ -0,0 +1,456 @@ + + + + + + + Class: TXTextControl::ReportingCloud::APIKey + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::APIKey + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/api_key.rb
+
+ +
+ +

Overview

+
+ +

Represents a ReportingCloud API key object.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(key, is_active = true) ⇒ APIKey + + + + + +

+
+ +

Returns a new instance of APIKey

+ + +
+
+
+

Parameters:

+
    + +
  • + + key + + + (String) + + + + — +
    +

    The actual API Key that belongs to the account.

    +
    + +
  • + +
  • + + is_active + + + (Boolean) + + + (defaults to: true) + + + — +
    +

    Specifies whether the API Key is active or not (not used yet).

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+26
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/api_key.rb', line 26
+
+def initialize(key, is_active = true)
+  self.key = key
+  @is_active = is_active
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #is_activeBoolean + + + + + +

+
+ +

Specifies whether the API Key is active or not (not used yet).

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of is_active

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+21
+22
+23
+
+
# File 'lib/txtextcontrol/reportingcloud/api_key.rb', line 21
+
+def is_active
+  @is_active
+end
+
+
+ + + +
+

+ + #keyString + + + + + +

+
+ +

The actual API Key that belongs to the account.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of key

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+21
+22
+23
+
+
# File 'lib/txtextcontrol/reportingcloud/api_key.rb', line 21
+
+def key
+  @key
+end
+
+
+ +
+ + +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/AccountSettings.html b/TXTextControl/ReportingCloud/AccountSettings.html new file mode 100644 index 0000000..18195ec --- /dev/null +++ b/TXTextControl/ReportingCloud/AccountSettings.html @@ -0,0 +1,1057 @@ + + + + + + + Class: TXTextControl::ReportingCloud::AccountSettings + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::AccountSettings + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/account_settings.rb
+
+ +
+ +

Overview

+
+ +

Represents ReportingCloud account settings.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Class Method Summary + collapse +

+ + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(serial_number, created_documents, uploaded_templates, max_documents, max_templates, valid_until = nil) ⇒ AccountSettings + + + + + +

+
+ +

Returns a new instance of AccountSettings

+ + +
+
+
+

Parameters:

+
    + +
  • + + serial_number + + + (String, Symbol) + + + + — +
    +

    The serial number that is attached to the account. Possible values are +:free, :trial and a 13 character long serial +number.

    +
    + +
  • + +
  • + + created_documents + + + (Integer) + + + + — +
    +

    The number of created documents in the current month.

    +
    + +
  • + +
  • + + uploaded_templates + + + (Integer) + + + + — +
    +

    The number of uploaded templates to the template storage.

    +
    + +
  • + +
  • + + max_documents + + + (Integer) + + + + — +
    +

    The maximum number of documents that can be created per month.

    +
    + +
  • + +
  • + + max_templates + + + (Integer) + + + + — +
    +

    The maximum number of templates that can be uploaded to the template +storage.

    +
    + +
  • + +
  • + + valid_until + + + (DateTime) + + + (defaults to: nil) + + + — +
    +

    The date until the current subscription is valid. Can be nil.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 51
+
+def initialize(serial_number, created_documents, uploaded_templates, max_documents, max_templates, valid_until = nil)
+  case serial_number.downcase
+    when "trial"
+      @serial_number = :trial
+    when "free"
+      @serial_number = :free
+    else 
+      @serial_number = serial_number
+  end                
+  @created_documents = Integer(created_documents)
+  @uploaded_templates = Integer(uploaded_templates)
+  @max_documents = Integer(max_documents)
+  @max_templates = Integer(max_templates)
+  case valid_until
+    when DateTime
+      @valid_until = valid_until
+    when String
+      @valid_until = DateTime.iso8601(valid_until)
+    else
+      @valid_until = nil      
+  end
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #created_documentsInteger (readonly) + + + + + +

+
+ +

The number of created documents in the current month.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of created_documents

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+31
+32
+33
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 31
+
+def created_documents
+  @created_documents
+end
+
+
+ + + +
+

+ + #max_documentsInteger (readonly) + + + + + +

+
+ +

The maximum number of documents that can be created per month.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of max_documents

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+31
+32
+33
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 31
+
+def max_documents
+  @max_documents
+end
+
+
+ + + +
+

+ + #max_templatesInteger (readonly) + + + + + +

+
+ +

The maximum number of templates that can be uploaded to the template +storage.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of max_templates

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+31
+32
+33
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 31
+
+def max_templates
+  @max_templates
+end
+
+
+ + + +
+

+ + #serial_numberString, Symbol (readonly) + + + + + +

+
+ +

The serial number that is attached to the account. Possible values are +:free, :trial and a 13 character long serial +number.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String, Symbol) + + + + — +
    +

    the current value of serial_number

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+31
+32
+33
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 31
+
+def serial_number
+  @serial_number
+end
+
+
+ + + +
+

+ + #uploaded_templatesInteger (readonly) + + + + + +

+
+ +

The number of uploaded templates to the template storage.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of uploaded_templates

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+31
+32
+33
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 31
+
+def uploaded_templates
+  @uploaded_templates
+end
+
+
+ + + +
+

+ + #valid_untilDateTime (readonly) + + + + + +

+
+ +

The date until the current subscription is valid. Can be nil.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (DateTime) + + + + — +
    +

    the current value of valid_until

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+31
+32
+33
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 31
+
+def valid_until
+  @valid_until
+end
+
+
+ +
+ + +
+

Class Method Details

+ + +
+

+ + .from_camelized_hash(hash) ⇒ AccountSettings + + + + + +

+
+ +

Creates an AccountSettings instance from a hash.

+ + +
+
+
+

Parameters:

+
    + +
  • + + hash + + + (Hash) + + + + — +
    +

    The hash to try and create an AccountSettings instance from.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (AccountSettings) + + + + — +
    +

    A newly created AccountSettings instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+77
+78
+79
+80
+81
+82
+83
+84
+85
+
+
# File 'lib/txtextcontrol/reportingcloud/account_settings.rb', line 77
+
+def self.from_camelized_hash(hash)
+  sn = hash["serialNumber"]
+  cd = hash["createdDocuments"]
+  ut = hash["uploadedTemplates"]
+  md = hash["maxDocuments"]
+  mt = hash["maxTemplates"]
+  vu = hash["validUntil"]
+  return AccountSettings.new(sn, cd, ut, md, mt, vu)
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/AppendBody.html b/TXTextControl/ReportingCloud/AppendBody.html new file mode 100644 index 0000000..9a208f3 --- /dev/null +++ b/TXTextControl/ReportingCloud/AppendBody.html @@ -0,0 +1,516 @@ + + + + + + + Class: TXTextControl::ReportingCloud::AppendBody + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::AppendBody + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/append_body.rb
+
+ +
+ +

Overview

+
+ +

Passes data to the ReportingCloud#append_documents method.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(documents, document_settings = nil) ⇒ AppendBody + + + + + +

+
+ +

Returns a new instance of AppendBody

+ + +
+
+
+ + +
+ + + + +
+
+
+
+27
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/append_body.rb', line 27
+
+def initialize(documents, document_settings = nil)
+  self.documents = documents
+  self.document_settings = document_settings
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #document_settingsDocumentSettings + + + + + +

+
+ +

Optional. Document settings to specify document properties such as title +and author.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (DocumentSettings) + + + + — +
    +

    the current value of document_settings

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/append_body.rb', line 25
+
+def document_settings
+  @document_settings
+end
+
+
+ + + +
+

+ + #documentsArray<AppendDocument> + + + + + +

+
+ +

The documents that are appended.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<AppendDocument>) + + + + — +
    +

    the current value of documents

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/append_body.rb', line 25
+
+def documents
+  @documents
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #to_camelized_hashHash + + + + + +

+
+ +

Converts an AppendBody instance to a hash while converting the attribute +names from snake case to camel case.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Hash) + + + + — +
    +

    A hash representing the AppendBody instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+62
+63
+64
+65
+66
+67
+
+
# File 'lib/txtextcontrol/reportingcloud/append_body.rb', line 62
+
+def to_camelized_hash
+  return {
+    "documents" => @documents.map { |d| d.to_camelized_hash },
+    "documentSettings" => @document_settings.nil? ? nil : @document_settings.to_camelized_hash
+  }
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/AppendDocument.html b/TXTextControl/ReportingCloud/AppendDocument.html new file mode 100644 index 0000000..b76174b --- /dev/null +++ b/TXTextControl/ReportingCloud/AppendDocument.html @@ -0,0 +1,534 @@ + + + + + + + Class: TXTextControl::ReportingCloud::AppendDocument + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::AppendDocument + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/append_document.rb
+
+ +
+ +

Overview

+
+ +

Passes data to the ReportingCloud#append_documents method.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(document, document_divider = :none) ⇒ AppendDocument + + + + + +

+
+ +

Returns a new instance of AppendDocument

+ + +
+
+
+ + +
+ + + + +
+
+
+
+25
+26
+27
+28
+
+
# File 'lib/txtextcontrol/reportingcloud/append_document.rb', line 25
+
+def initialize(document, document_divider = :none)
+  self.document = document
+  @document_divider = document_divider
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #documentString + + + + + +

+
+ +

The document as a Base64 encoded string.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of document

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+22
+23
+24
+
+
# File 'lib/txtextcontrol/reportingcloud/append_document.rb', line 22
+
+def document
+  @document
+end
+
+
+ + + +
+

+ + #document_dividerSymbol + + + + + +

+
+ +

The document divider option. Possible values are :none, +:new_paragraph and :new_section.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Symbol) + + + + — +
    +

    the current value of document_divider

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+22
+23
+24
+
+
# File 'lib/txtextcontrol/reportingcloud/append_document.rb', line 22
+
+def document_divider
+  @document_divider
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #to_camelized_hashHash + + + + + +

+
+ +

Converts an AppendBody instance to a hash while converting the attribute +names from snake case to camel case.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Hash) + + + + — +
    +

    A hash representing the AppendBody instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+
+
# File 'lib/txtextcontrol/reportingcloud/append_document.rb', line 44
+
+def to_camelized_hash
+  result = {
+    "document" => @document,
+    "documentDivider" => "None"
+  }
+
+  case @document_divider
+  when :new_paragraph
+    result["documentDivider"] = "NewParagraph"
+  when :new_section
+    result["documentDivider"] = "NewSection"
+  end
+
+  return result
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/DocumentSettings.html b/TXTextControl/ReportingCloud/DocumentSettings.html new file mode 100644 index 0000000..61387ed --- /dev/null +++ b/TXTextControl/ReportingCloud/DocumentSettings.html @@ -0,0 +1,980 @@ + + + + + + + Class: TXTextControl::ReportingCloud::DocumentSettings + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::DocumentSettings + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/document_settings.rb
+
+ +
+ +

Overview

+
+ +

Holds the merge settings needed by the ReportingCloud#append_documents +method.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+

Direct Known Subclasses

+

MergeSettings

+
+ + + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initializeDocumentSettings + + + + + +

+
+ +

Returns a new instance of DocumentSettings

+ + +
+
+
+ + +
+ + + + +
+
+
+
+34
+35
+36
+37
+38
+39
+40
+41
+42
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 34
+
+def initialize
+  @author = nil
+  @creation_date = nil
+  @creator_application = nil
+  @document_subject = nil
+  @document_title = nil
+  @last_modification_date = nil
+  @user_password = nil
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #authorString + + + + + +

+
+ +

The document's author.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of author

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def author
+  @author
+end
+
+
+ + + +
+

+ + #creation_dateDateTime + + + + + +

+
+ +

The document's creation date.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (DateTime) + + + + — +
    +

    the current value of creation_date

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def creation_date
+  @creation_date
+end
+
+
+ + + +
+

+ + #creator_applicationString + + + + + +

+
+ +

The application which created the document.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of creator_application

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def creator_application
+  @creator_application
+end
+
+
+ + + +
+

+ + #document_subjectString + + + + + +

+
+ +

The document's subject.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of document_subject

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def document_subject
+  @document_subject
+end
+
+
+ + + +
+

+ + #document_titleString + + + + + +

+
+ +

The document's title.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of document_title

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def document_title
+  @document_title
+end
+
+
+ + + +
+

+ + #last_modification_dateDateTime + + + + + +

+
+ +

The document's last modification date.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (DateTime) + + + + — +
    +

    the current value of last_modification_date

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def last_modification_date
+  @last_modification_date
+end
+
+
+ + + +
+

+ + #user_passwordString + + + + + +

+
+ +

The password needed to open the document.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of user_password

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 27
+
+def user_password
+  @user_password
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #to_camelized_hashHash + + + + + +

+
+ +

Converts a DocumentSettings instance to a hash while converting the +attribute names from snake case to camel case.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Hash) + + + + — +
    +

    A hash representing the DocumentSettings instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+79
+80
+81
+82
+83
+84
+85
+86
+87
+88
+89
+
+
# File 'lib/txtextcontrol/reportingcloud/document_settings.rb', line 79
+
+def to_camelized_hash
+  return {
+    "author" => @author,
+    "creationDate" => @creation_date.nil? ? nil : @creation_date.iso8601,
+    "creatorApplication" => @creator_application,
+    "documentSubject" => @document_subject,
+    "documentTitle" => @document_title,
+    "lastModificationDate" => @last_modification_date.nil? ? nil : @last_modification_date.iso8601,
+    "userPassword" => @user_password
+  }
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/FindAndReplaceBody.html b/TXTextControl/ReportingCloud/FindAndReplaceBody.html new file mode 100644 index 0000000..305c615 --- /dev/null +++ b/TXTextControl/ReportingCloud/FindAndReplaceBody.html @@ -0,0 +1,654 @@ + + + + + + + Class: TXTextControl::ReportingCloud::FindAndReplaceBody + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::FindAndReplaceBody + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/find_and_replace_body.rb
+
+ +
+ +

Overview

+
+ +

The request body of requests to the endpoint “/document/findandreplace”. +Contains an array of string arrays, a template encoded as a Base64 string +and a ReportingCloud MergeSettings object.

+ + +
+
+
+ + +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(find_and_replace_data, template = nil, merge_settings = nil) ⇒ FindAndReplaceBody + + + + + +

+
+ +

Returns a new instance of FindAndReplaceBody

+ + +
+
+
+

Parameters:

+
    + +
  • + + find_and_replace_data + + + (Array<Array<String>>) + + + + — +
    +

    The find and replace pair values as an array of string arrays.

    +
    + +
  • + +
  • + + template + + + (String) + + + (defaults to: nil) + + + — +
    +

    The source document encoded as a Base64 string. The supported document +formats are .rtf, .doc, .docx, and +.tx.

    +
    + +
  • + +
  • + + merge_settings + + + (MergeSettings) + + + (defaults to: nil) + + + — +
    +

    Merge settings to specify merge properties and document properties such as +title and author.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+38
+39
+40
+41
+42
+
+
# File 'lib/txtextcontrol/reportingcloud/find_and_replace_body.rb', line 38
+
+def initialize(find_and_replace_data, template = nil, merge_settings = nil)
+  self.find_and_replace_data = find_and_replace_data
+  self.template = template
+  self.merge_settings = merge_settings
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #find_and_replace_dataArray<Array<String>> + + + + + +

+
+ +

The find and replace pair values as an array of string arrays.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<Array<String>>) + + + + — +
    +

    the current value of find_and_replace_data

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/find_and_replace_body.rb', line 27
+
+def find_and_replace_data
+  @find_and_replace_data
+end
+
+
+ + + +
+

+ + #merge_settingsMergeSettings + + + + + +

+
+ +

Merge settings to specify merge properties and document properties such as +title and author.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (MergeSettings) + + + + — +
    +

    the current value of merge_settings

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/find_and_replace_body.rb', line 27
+
+def merge_settings
+  @merge_settings
+end
+
+
+ + + +
+

+ + #templateString + + + + + +

+
+ +

The source document encoded as a Base64 string.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of template

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/find_and_replace_body.rb', line 27
+
+def template
+  @template
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #to_camelized_hashHash + + + + + +

+
+ +

Converts a FindAndReplaceBody instance to a hash while converting the +attribute names from snake case to camel case.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Hash) + + + + — +
    +

    A hash representing the FindAndReplaceBody instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+81
+82
+83
+84
+85
+86
+87
+
+
# File 'lib/txtextcontrol/reportingcloud/find_and_replace_body.rb', line 81
+
+def to_camelized_hash
+  return {
+    "findAndReplaceData" => @find_and_replace_data,
+    "template" => @template,
+    "mergeSettings" => @merge_settings
+  }
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/IncorrectWord.html b/TXTextControl/ReportingCloud/IncorrectWord.html new file mode 100644 index 0000000..4c1c183 --- /dev/null +++ b/TXTextControl/ReportingCloud/IncorrectWord.html @@ -0,0 +1,919 @@ + + + + + + + Class: TXTextControl::ReportingCloud::IncorrectWord + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::IncorrectWord + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/incorrect_word.rb
+
+ +
+ +

Overview

+
+ +

Represents an incorrect word in spell checked text.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Class Method Summary + collapse +

+ + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(length, start, text, is_duplicate, language) ⇒ IncorrectWord + + + + + +

+
+ +

Returns a new instance of IncorrectWord

+ + +
+
+
+

Parameters:

+
    + +
  • + + length + + + (Integer) + + + + — +
    +

    The starting position of a spelled word.

    +
    + +
  • + +
  • + + start + + + (Integer) + + + + — +
    +

    The starting position of a spelled word.

    +
    + +
  • + +
  • + + text + + + (String) + + + + — +
    +

    The text of the spelled word.

    +
    + +
  • + +
  • + + is_duplicate + + + (Boolean) + + + + — +
    +

    Indicating whether the spelled word is declared as incorrect, because the +previous word has the same text.

    +
    + +
  • + +
  • + + language + + + (String) + + + + — +
    +

    Indicating the language the incorrect word was spelled.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+42
+43
+44
+45
+46
+47
+48
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 42
+
+def initialize(length, start, text, is_duplicate, language)
+  @length = Integer(length)
+  @start = Integer(start)
+  @text = text
+  @is_duplicate = !!is_duplicate
+  @language = language
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #is_duplicateBoolean (readonly) + + + + Also known as: + is_duplicate? + + + + +

+
+ +

Indicating whether the spelled word is declared as incorrect, because the +previous word has the same text.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of is_duplicate

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+26
+27
+28
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 26
+
+def is_duplicate
+  @is_duplicate
+end
+
+
+ + + +
+

+ + #languageString (readonly) + + + + + +

+
+ +

Indicating the language the incorrect word was spelled.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of language

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+26
+27
+28
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 26
+
+def language
+  @language
+end
+
+
+ + + +
+

+ + #lengthInteger (readonly) + + + + + +

+
+ +

The length of the spelled word.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of length

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+26
+27
+28
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 26
+
+def length
+  @length
+end
+
+
+ + + +
+

+ + #startInteger (readonly) + + + + + +

+
+ +

The starting position of a spelled word.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of start

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+26
+27
+28
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 26
+
+def start
+  @start
+end
+
+
+ + + +
+

+ + #textString (readonly) + + + + + +

+
+ +

The text of the spelled word.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of text

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+26
+27
+28
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 26
+
+def text
+  @text
+end
+
+
+ +
+ + +
+

Class Method Details

+ + +
+

+ + .from_camelized_hash(hash) ⇒ IncorrectWord + + + + + +

+
+ +

Creates an IncorrectWord instance from a hash.

+ + +
+
+
+

Parameters:

+
    + +
  • + + hash + + + (Hash) + + + + — +
    +

    The hash to try and create an IncorrectWord instance from.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (IncorrectWord) + + + + — +
    +

    A newly created IncorrectWord instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+53
+54
+55
+56
+57
+58
+59
+60
+
+
# File 'lib/txtextcontrol/reportingcloud/incorrect_word.rb', line 53
+
+def self.from_camelized_hash(hash)
+  l = hash["length"]
+  s = hash["start"]
+  txt = hash["text"]
+  id = hash["isDuplicate"]
+  lan = hash["language"]
+  return IncorrectWord.new(l, s, txt, id, lan)
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/MergeBlock.html b/TXTextControl/ReportingCloud/MergeBlock.html new file mode 100644 index 0000000..4231994 --- /dev/null +++ b/TXTextControl/ReportingCloud/MergeBlock.html @@ -0,0 +1,676 @@ + + + + + + + Class: TXTextControl::ReportingCloud::MergeBlock + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::MergeBlock + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/merge_block.rb
+
+ +
+ +

Overview

+
+ +

Represents a merge block in a document template.

+ + +
+
+
+ + +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Class Method Summary + collapse +

+ + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(name, merge_blocks, merge_fields) ⇒ MergeBlock + + + + + +

+
+ +

Returns a new instance of MergeBlock

+ + +
+
+
+ +

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_block.rb', line 30
+
+def initialize(name, merge_blocks, merge_fields)
+  # Parameter validation
+  raise ArgumentError, "Block name must be a string." if !name.kind_of? String
+  raise ArgumentError, "Parameter merge_blocks must be an array." if !merge_blocks.kind_of? Array
+  raise ArgumentError, "Parameter merge_fields must be an array." if !merge_fields.kind_of? Array
+
+  @name = name
+  @merge_blocks = merge_blocks
+  @merge_fields = merge_fields
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #merge_blocksArray<MergeBlock> (readonly) + + + + + +

+
+ +

The merge blocks nested inside the merge block.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<MergeBlock>) + + + + — +
    +

    the current value of merge_blocks

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_block.rb', line 25
+
+def merge_blocks
+  @merge_blocks
+end
+
+
+ + + +
+

+ + #merge_fieldsArray<MergeField> (readonly) + + + + + +

+
+ +

The merge fields inside the merge block.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<MergeField>) + + + + — +
    +

    the current value of merge_fields

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_block.rb', line 25
+
+def merge_fields
+  @merge_fields
+end
+
+
+ + + +
+

+ + #nameString (readonly) + + + + + +

+
+ +

The merge block's' name.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of name

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_block.rb', line 25
+
+def name
+  @name
+end
+
+
+ +
+ + +
+

Class Method Details

+ + +
+

+ + .from_camelized_hash(hash) ⇒ MergeBlock + + + + + +

+
+ +

Creates an MergeBlock instance from a hash.

+ + +
+
+
+

Parameters:

+
    + +
  • + + hash + + + (Hash) + + + + — +
    +

    The hash to try and create an MergeBlock instance from.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (MergeBlock) + + + + — +
    +

    A newly created MergeBlock instance.

    +
    + +
  • + +
+

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_block.rb', line 44
+
+def self.from_camelized_hash(hash) 
+  # Parameter validation
+  raise ArgumentError, "Parameter must be a Hash." if !hash.kind_of? Hash
+
+  name = hash["name"]
+  blocks = Array.new
+  hash["mergeBlocks"].each do |elem|
+    blocks.push(MergeBlock.from_camelized_hash(elem))
+  end
+  fields = Array.new 
+  hash["mergeFields"].each do |elem|
+    fields.push(MergeField.from_camelized_hash(elem))
+  end
+  return MergeBlock.new(name, blocks, fields)
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/MergeBody.html b/TXTextControl/ReportingCloud/MergeBody.html new file mode 100644 index 0000000..0a35ab6 --- /dev/null +++ b/TXTextControl/ReportingCloud/MergeBody.html @@ -0,0 +1,668 @@ + + + + + + + Class: TXTextControl::ReportingCloud::MergeBody + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::MergeBody + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/merge_body.rb
+
+ +
+ +

Overview

+
+ +

Passes data to the ReportingCloud#merge_document method.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(merge_data, merge_settings = nil, template = nil) ⇒ MergeBody + + + + + +

+
+ +

The constructor.

+ + +
+
+
+

Parameters:

+
    + +
  • + + merge_data + + + (Array<Hash>) + + + + — +
    +

    The merge data. Must be an array of hashes.

    +
    + +
  • + +
  • + + template + + + (String) + + + (defaults to: nil) + + + — +
    +

    Base64 encoded template document. Supported formats are RTF, DOC, DOCX and +TX.

    +
    + +
  • + +
  • + + merge_settings + + + (MergeSettings) + + + (defaults to: nil) + + + — +
    +

    Merge settings to specify merge properties and document properties such as +title and author.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+38
+39
+40
+41
+42
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_body.rb', line 38
+
+def initialize(merge_data, merge_settings = nil, template = nil)
+  self.merge_data = merge_data
+  @template = template
+  @merge_settings = merge_settings
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #merge_dataArray<Hash> + + + + + +

+
+ +

The merge data. Must be an array of hashes.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<Hash>) + + + + — +
    +

    the current value of merge_data

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_body.rb', line 27
+
+def merge_data
+  @merge_data
+end
+
+
+ + + +
+

+ + #merge_settingsMergeSettings + + + + + +

+
+ +

Merge settings to specify merge properties and document properties such as +title and author.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (MergeSettings) + + + + — +
    +

    the current value of merge_settings

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_body.rb', line 27
+
+def merge_settings
+  @merge_settings
+end
+
+
+ + + +
+

+ + #templateString + + + + + +

+
+ +

Base64 encoded template document. Supported formats are RTF, DOC, DOCX and +TX.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of template

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+27
+28
+29
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_body.rb', line 27
+
+def template
+  @template
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #to_camelized_hashHash + + + + + +

+
+ +

Converts a MergeBody instance to a hash while converting the attribute +names from snake case to camel case.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Hash) + + + + — +
    +

    A hash representing the MergeBody instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+58
+59
+60
+61
+62
+63
+64
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_body.rb', line 58
+
+def to_camelized_hash
+  return {
+    "mergeData" => @merge_data,
+    "template" => @template,
+    "mergeSettings" => @merge_settings.nil? ? nil : @merge_settings.to_camelized_hash
+  }
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/MergeField.html b/TXTextControl/ReportingCloud/MergeField.html new file mode 100644 index 0000000..ed5b031 --- /dev/null +++ b/TXTextControl/ReportingCloud/MergeField.html @@ -0,0 +1,1056 @@ + + + + + + + Class: TXTextControl::ReportingCloud::MergeField + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::MergeField + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/merge_field.rb
+
+ +
+ +

Overview

+
+ +

Represents a merge field in a document template.

+ + +
+
+
+ + +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Class Method Summary + collapse +

+ + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(date_time_format, name, numeric_format, preserve_formatting, text, text_after, text_before) ⇒ MergeField + + + + + +

+
+ +

Returns a new instance of MergeField

+ + +
+
+
+ +

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 37
+
+def initialize(date_time_format, name, numeric_format, preserve_formatting, text, text_after, text_before)
+  # Parameter validation
+  unless date_time_format.nil? || (date_time_format.kind_of? String)
+    raise ArgumentError, "Date / time format must be a string."
+  end
+  raise ArgumentError, "Field name must be a string." if !name.kind_of? String
+  unless numeric_format.nil? || (numeric_format.kind_of? String)
+    raise ArgumentError, "Numeric format must be a string"
+  end
+  raise ArgumentError, "Preserve formatting parameter must be a boolean value." if !!preserve_formatting != preserve_formatting
+  raise ArgumentError, "Field text must be a string." if !text.kind_of? String
+  raise ArgumentError, "Text after must be a string." if !text_after.nil? && (!text_after.kind_of? String)
+  raise ArgumentError, "Text before must be a string." if !text_before.nil? && (!text_before.kind_of? String)
+
+  @date_time_format = date_time_format
+  @name = name
+  @numeric_format = numeric_format
+  @preserve_formatting = preserve_formatting
+  @text = text
+  @text_after = text_after
+  @text_before = text_before
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #date_time_formatString (readonly) + + + + + +

+
+ +

The format which is applied to date / time values.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of date_time_format

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def date_time_format
+  @date_time_format
+end
+
+
+ + + +
+

+ + #nameString (readonly) + + + + + +

+
+ +

The name of the field.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of name

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def name
+  @name
+end
+
+
+ + + +
+

+ + #numeric_formatString (readonly) + + + + + +

+
+ +

The format which is applied to numeric values.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of numeric_format

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def numeric_format
+  @numeric_format
+end
+
+
+ + + +
+

+ + #preserve_formattingBoolean (readonly) + + + + + +

+
+ +

Specifies whether formatting is preserved.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of preserve_formatting

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def preserve_formatting
+  @preserve_formatting
+end
+
+
+ + + +
+

+ + #textString (readonly) + + + + + +

+
+ +

The field text.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of text

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def text
+  @text
+end
+
+
+ + + +
+

+ + #text_afterString (readonly) + + + + + +

+
+ +

The text after the field.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of text_after

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def text_after
+  @text_after
+end
+
+
+ + + +
+

+ + #text_beforeString (readonly) + + + + + +

+
+ +

The text before the field.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of text_before

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 28
+
+def text_before
+  @text_before
+end
+
+
+ +
+ + +
+

Class Method Details

+ + +
+

+ + .from_camelized_hash(hash) ⇒ MergeField + + + + + +

+
+ +

Creates an MergeField instance from a hash.

+ + +
+
+
+

Parameters:

+
    + +
  • + + hash + + + (Hash) + + + + — +
    +

    The hash to try and create an MergeField instance from.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (MergeField) + + + + — +
    +

    A newly created MergeField instance.

    +
    + +
  • + +
+

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73
+74
+75
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_field.rb', line 63
+
+def self.from_camelized_hash(hash) 
+  # Parameter validation
+  raise ArgumentError, "Parameter must be a Hash." if !hash.kind_of? Hash
+
+  date_time_format = hash["dateTimeFormat"]
+  name = hash["name"]
+  numeric_format = hash["numericFormat"]
+  preserve_formatting = hash["preserveFormatting"]
+  text = hash["text"]
+  text_after = hash["textAfter"]
+  text_before = hash["textBefore"]
+  return MergeField.new(date_time_format, name, numeric_format, preserve_formatting, text, text_after, text_before)
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/MergeSettings.html b/TXTextControl/ReportingCloud/MergeSettings.html new file mode 100644 index 0000000..c8ebf6d --- /dev/null +++ b/TXTextControl/ReportingCloud/MergeSettings.html @@ -0,0 +1,844 @@ + + + + + + + Class: TXTextControl::ReportingCloud::MergeSettings + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::MergeSettings + + + +

+
+ +
+
Inherits:
+
+ DocumentSettings + +
    +
  • Object
  • + + + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/merge_settings.rb
+
+ +
+ +

Overview

+
+ +

Holds the merge settings needed by the merge method.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

Attributes inherited from DocumentSettings

+

#author, #creation_date, #creator_application, #document_subject, #document_title, #last_modification_date, #user_password

+ + + +

+ Instance Method Summary + collapse +

+ + + + + + + + + + +
+

Constructor Details

+ +
+

+ + #initializeMergeSettings + + + + + +

+
+ +

Returns a new instance of MergeSettings

+ + +
+
+
+ + +
+ + + + +
+
+
+
+46
+47
+48
+49
+50
+51
+52
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 46
+
+def initialize
+  @remove_empty_fields = true
+  @remove_empty_blocks = true
+  @remove_empty_images = true
+  @remove_trailing_whitespace = true
+  @merge_html = false
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #merge_htmlBoolean + + + + Also known as: + merge_html? + + + + +

+
+ +

Specifies whether field data can contain formatted Html content or not. +The default value is false. Html content must be enclosed in an <html +/> tag element. Only active in the Merge endpoint.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of merge_html

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+33
+34
+35
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 33
+
+def merge_html
+  @merge_html
+end
+
+
+ + + +
+

+ + #remove_empty_blocksBoolean + + + + Also known as: + remove_empty_blocks? + + + + +

+
+ +

Specifies whether the content of empty merge blocks should be removed from +the template or not.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of remove_empty_blocks

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+33
+34
+35
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 33
+
+def remove_empty_blocks
+  @remove_empty_blocks
+end
+
+
+ + + +
+

+ + #remove_empty_fieldsBoolean + + + + Also known as: + remove_empty_fields? + + + + +

+
+ +

Specifies whether empty fields should be removed from the template or not.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of remove_empty_fields

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+33
+34
+35
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 33
+
+def remove_empty_fields
+  @remove_empty_fields
+end
+
+
+ + + +
+

+ + #remove_empty_imagesBoolean + + + + Also known as: + remove_empty_images? + + + + +

+
+ +

Specifies whether images which don't have merge data should be removed +from the template or not.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of remove_empty_images

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+33
+34
+35
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 33
+
+def remove_empty_images
+  @remove_empty_images
+end
+
+
+ + + +
+

+ + #remove_trailing_whitespaceBoolean + + + + Also known as: + remove_trailing_whitespace? + + + + +

+
+ +

Specifies whether trailing whitespace should be removed before saving a +document.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    the current value of remove_trailing_whitespace

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+33
+34
+35
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 33
+
+def remove_trailing_whitespace
+  @remove_trailing_whitespace
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #to_camelized_hashHash + + + + + +

+
+ +

Converts a MergeSettings instance to a hash while converting the attribute +names from snake case to camel case.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Hash) + + + + — +
    +

    A hash representing the MergeSettings instance.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+
+
# File 'lib/txtextcontrol/reportingcloud/merge_settings.rb', line 57
+
+def to_camelized_hash
+  result = {
+    "removeEmptyFields" => @remove_empty_fields,
+    "removeEmptyBlocks" => @remove_empty_blocks,
+    "removeEmptyImages" => @remove_empty_images,
+    "removeTrailingWhitespace" => @remove_trailing_whitespace,
+    "mergeHtml" => @merge_html,
+  }
+  result.merge(super)
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/ReportingCloud.html b/TXTextControl/ReportingCloud/ReportingCloud.html new file mode 100644 index 0000000..f5e0962 --- /dev/null +++ b/TXTextControl/ReportingCloud/ReportingCloud.html @@ -0,0 +1,3585 @@ + + + + + + + Class: TXTextControl::ReportingCloud::ReportingCloud + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::ReportingCloud + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/reportingcloud.rb
+
+ +
+ +

Overview

+
+ +

The main class.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(username, password, base_url = nil) ⇒ ReportingCloud + + + + + +

+
+ +

Returns a new instance of ReportingCloud

+ + +
+
+
+

Parameters:

+
    + +
  • + + username + + + (String) + + + + — +
    +

    The user name.

    +
    + +
  • + +
  • + + password + + + (String) + + + + — +
    +

    The password.

    +
    + +
  • + +
  • + + base_url + + + (String) + + + (defaults to: nil) + + + — +
    +

    The API base url. Is set to “https://api.reporting.cloud” by +default.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+53
+54
+55
+56
+57
+58
+59
+60
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 53
+
+def initialize(username, password, base_url = nil)
+  base_url ||= DEFAULT_BASE_URI
+  @username = username
+  @password = password
+  @api_version = DEFAULT_VERSION
+  @read_timeout = DEFAULT_TIMEOUT   
+  @base_uri = URI.parse(base_url)
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #api_versionString + + + + + +

+
+ +

The API version. Is set to “v1” by default.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of api_version

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+42
+43
+44
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 42
+
+def api_version
+  @api_version
+end
+
+
+ + + +
+

+ + #base_uriString + + + + + +

+
+ +

The API base url. Is set to “https://api.reporting.cloud” by +default.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of base_uri

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+42
+43
+44
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 42
+
+def base_uri
+  @base_uri
+end
+
+
+ + + +
+

+ + #passwordString + + + + + +

+
+ +

The password.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of password

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+42
+43
+44
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 42
+
+def password
+  @password
+end
+
+
+ + + +
+

+ + #read_timeoutInteger + + + + + +

+
+ +

The timeout for HTTP requests in seconds. Is set to 10 by +default.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of read_timeout

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+42
+43
+44
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 42
+
+def read_timeout
+  @read_timeout
+end
+
+
+ + + +
+

+ + #usernameString + + + + + +

+
+ +

The user name.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of username

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+42
+43
+44
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 42
+
+def username
+  @username
+end
+
+
+ +
+ + +
+

Instance Method Details

+ + +
+

+ + #append_documents(append_body, return_format = :pdf, test = false) ⇒ String + + + + + +

+
+ +

Combines documents by appending them divided by a new section, paragraph or +nothing.

+ + +
+
+
+

Parameters:

+
    + +
  • + + append_body + + + (TXTextControl::ReportingCloud::AppendBody) + + + + — +
    +

    The AppendBody object contains the templates and a DocumentSettings +object.

    +
    + +
  • + +
  • + + return_format + + + (Symbol) + + + (defaults to: :pdf) + + + — +
    +

    The format of the created document. Possible values are :pdf, +:rtf, :doc, :docx, +:html, :tx and :txt.

    +
    + +
  • + +
  • + + test + + + (Boolean) + + + (defaults to: false) + + + — +
    +

    Specifies whether it is a test run or not. A test run is not counted +against the quota and created documents contain a watermark.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    The resulting document as a Base64 string.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+138
+139
+140
+141
+142
+143
+144
+145
+146
+147
+148
+149
+150
+151
+152
+153
+154
+155
+156
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 138
+
+def append_documents(append_body, return_format = :pdf, test = false)
+  unless append_body.is_a?(TXTextControl::ReportingCloud::AppendBody)
+    raise ArgumentError, "append_body must be an AppendBody instance."
+  end
+
+  # Create query parameters
+  params = {
+    :returnFormat => return_format,
+    :test => test
+  }
+
+  # Send request
+  res = request("/document/append", :post, params, append_body)
+  if res.kind_of? Net::HTTPSuccess
+    return res.body.remove_first_and_last
+  else
+    raise res.body 
+  end        
+end
+
+
+ +
+

+ + #check_text(text, language) ⇒ Array<IncorrectWord> + + + + + +

+
+ +

Checks text for spelling errors.

+ + +
+
+
+

Parameters:

+
    + +
  • + + text + + + (String) + + + + — +
    +

    The text to spell check.

    +
    + +
  • + +
  • + + language + + + (String) + + + + — +
    +

    The language that is used to spell check the specified text.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Array<IncorrectWord>) + + + + — +
    +

    An array of incorrect words.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+380
+381
+382
+383
+384
+385
+386
+387
+388
+389
+390
+391
+392
+393
+394
+395
+396
+397
+398
+399
+400
+401
+402
+403
+404
+405
+406
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 380
+
+def check_text(text, language)
+  # Parameter validation
+  unless !text.nil? && !text.to_s.empty?
+    raise ArgumentError, "The given text must not be empty."
+  end        
+  unless !language.nil? && !language.to_s.empty?
+    raise ArgumentError, "A language must be defined."
+  end        
+  
+  # Create query parameters
+  params = {
+    :text => text,
+    :language => language
+  }
+
+  res = request("/proofing/check", :get, params)
+  if res.kind_of? Net::HTTPSuccess
+    incorrect_words = Array.new
+    data = JSON.parse(res.body, object_class: OpenStruct)
+    data.each do |elem|
+      incorrect_words.push(IncorrectWord.from_camelized_hash(elem))
+    end          
+    return incorrect_words
+  else
+    raise res.body
+  end          
+end
+
+
+ +
+

+ + #convert_document(template_data, return_format = :pdf, test = false) ⇒ String + + + + + +

+
+ +

Converts a document to another format.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_data + + + (String) + + + + — +
    +

    The source document encoded as a Base64 string. The supported document +formats are .rtf, .doc, .docx, +.html, .pdf and .tx.

    +
    + +
  • + +
  • + + return_format + + + (Symbol) + + + (defaults to: :pdf) + + + — +
    +

    The format of the created document. Possible values are: :pdf, +:rtf, :doc, :docx, +:html, :tx and :txt.

    +
    + +
  • + +
  • + + test + + + (Boolean) + + + (defaults to: false) + + + — +
    +

    Specifies whether it is a test run or not. A test run is not counted +against the quota and created documents contain a watermark.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    The created document encoded as a Base64 string.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+292
+293
+294
+295
+296
+297
+298
+299
+300
+301
+302
+303
+304
+305
+306
+307
+308
+309
+310
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 292
+
+def convert_document(template_data, return_format = :pdf, test = false)
+  # Parameter validation
+  TemplateDataValidator.validate(template_data)
+  
+  # Create query parameters
+  params = {
+    :returnFormat => return_format,
+    :test => test
+  }
+
+  res = request("/document/convert", :post, params, template_data)
+  if res.kind_of? Net::HTTPSuccess
+    # Remove leading and trailing quote from string 
+    # (inexplicably JSON.parse chokes on simple strings)
+    return res.body.remove_first_and_last
+  else
+    raise res.body 
+  end                
+end
+
+
+ +
+

+ + #create_api_keyString + + + + + +

+
+ +

Creates and returns a new API key.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    The new API key.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+453
+454
+455
+456
+457
+458
+459
+460
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 453
+
+def create_api_key
+  res = request("/account/apikey", :put)
+  if res.kind_of? Net::HTTPSuccess
+    return res.body.remove_first_and_last
+  else
+    raise res.body 
+  end                
+end
+
+
+ +
+

+ + #delete_api_key(key) ⇒ Object + + + + + +

+
+ +

Deletes a given API Key from the account.

+ + +
+
+
+

Parameters:

+
    + +
  • + + key + + + (String) + + + + — +
    +

    The key to delete from the account.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+464
+465
+466
+467
+468
+469
+470
+471
+472
+473
+474
+475
+476
+477
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 464
+
+def delete_api_key(key)
+  # Parameter validation
+  unless !key.nil? && !key.to_s.empty?
+    raise ArgumentError, "The given key must not be empty."
+  end        
+
+  # Create query parameters
+  params = {
+    :key => key
+  }
+
+  res = request("/account/apikey", :delete, params)
+  raise res.body unless res.kind_of? Net::HTTPSuccess
+end
+
+
+ +
+

+ + #delete_template(template_name) ⇒ void + + + + + +

+
+

This method returns an undefined value.

+

Deletes a template from the template storage.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template to be deleted from the template storage.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+203
+204
+205
+206
+207
+208
+209
+210
+211
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 203
+
+def delete_template(template_name)
+  # Parameter validation
+  TemplateNameValidator.validate(template_name)
+  
+  res = request("/templates/delete", :delete, { :templateName => template_name })
+  unless res.kind_of? Net::HTTPSuccess
+    raise res.body 
+  end
+end
+
+
+ +
+

+ + #download_template(template_name) ⇒ String + + + + + +

+
+ +

Returns the selected template from the storage.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template in the template storage.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    The template document data as a Base64 encoded string.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+233
+234
+235
+236
+237
+238
+239
+240
+241
+242
+243
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 233
+
+def download_template(template_name)
+  # Parameter validation
+  TemplateNameValidator.validate(template_name)
+
+  res = request("/templates/download", :get, { :templateName => template_name })        
+  if res.kind_of? Net::HTTPSuccess
+    return res.body.remove_first_and_last
+  else
+    raise res.body
+  end
+end
+
+
+ +
+

+ + #find_and_replace(find_and_replace_body, template_name = nil, return_format = :pdf, test = false) ⇒ String + + + + + +

+
+ +

Executes a find and replace on a template.

+ + +
+
+
+

Parameters:

+
    + +
  • + + find_and_replace_body + + + (FindAndReplaceBody) + + + + — +
    +

    The request body.

    +
    + +
  • + +
  • + + template_name + + + (String) + + + (defaults to: nil) + + + — +
    +

    The name of the template in the template storage. If no template is +specified, the template must be included in the FindAndReplaceBody object +of this request.

    +
    + +
  • + +
  • + + return_format + + + (Symbol) + + + (defaults to: :pdf) + + + — +
    +

    The format of the created document. Possible values are: :pdf, +:rtf, :doc, :docx, +:html, :tx and :txt.

    +
    + +
  • + +
  • + + test + + + (Boolean) + + + (defaults to: false) + + + — +
    +

    Specifies whether it is a test run or not. A test run is not counted +against the quota and created documents contain a watermark.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    The created document encoded as a Base64 string.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+338
+339
+340
+341
+342
+343
+344
+345
+346
+347
+348
+349
+350
+351
+352
+353
+354
+355
+356
+357
+358
+359
+360
+361
+362
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 338
+
+def find_and_replace(find_and_replace_body, template_name = nil, return_format = :pdf, test = false)
+  # Parameter validation
+  unless !find_and_replace_body.nil? && (find_and_replace_body.kind_of? FindAndReplaceBody) 
+    raise ArgumentError, "Request body must be of type FindAndReplaceBody."
+  end
+  unless template_name.nil? || !template_name.to_s.empty?
+    raise ArgumentError, "Template name must be a non empty string."
+  end        
+  
+  # Create query parameters
+  params = {
+    :returnFormat => return_format,
+    :templateName => template_name,
+    :test => test
+  }
+
+  res = request("/document/findandreplace", :post, params, find_and_replace_body)
+  if res.kind_of? Net::HTTPSuccess
+    # Remove leading and trailing quote from string 
+    # (inexplicably JSON.parse chokes on simple strings)
+    return res.body.remove_first_and_last
+  else
+    raise res.body 
+  end                
+end
+
+
+ +
+

+ + #get_account_settingsAccountSettings + + + + + +

+
+ +

Returns the account settings.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (AccountSettings) + + + + — +
    +

    The account settings.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+160
+161
+162
+163
+164
+165
+166
+167
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 160
+
+def 
+  res = request("/account/settings", :get)
+  if res.kind_of? Net::HTTPSuccess
+    return AccountSettings.from_camelized_hash(JSON.parse(res.body))
+  else
+    raise res.body
+  end
+end
+
+
+ +
+

+ + #get_api_keysArray<String> + + + + + +

+
+ +

Returns all available API Keys of the current account.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<String>) + + + + — +
    +

    All available API Keys of the current account.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+481
+482
+483
+484
+485
+486
+487
+488
+489
+490
+491
+492
+493
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 481
+
+def get_api_keys 
+  res = request("/account/apikeys", :get)
+  if res.kind_of? Net::HTTPSuccess
+    keys = Array.new
+    data = JSON.parse(res.body, object_class: OpenStruct)
+    data.each do |elem|
+      keys.push(APIKey.new(elem.key, elem.active))
+    end
+    return keys
+  else
+    raise res.body
+  end        
+end
+
+
+ +
+

+ + #get_available_dictionariesArray<String> + + + + + +

+
+ +

Returns all available dictionary names.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<String>) + + + + — +
    +

    Available dictionary names.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+410
+411
+412
+413
+414
+415
+416
+417
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 410
+
+def get_available_dictionaries
+  res = request("/proofing/availabledictionaries", :get)
+  if res.kind_of? Net::HTTPSuccess
+    return JSON.parse(res.body)
+  else
+    raise res.body
+  end                
+end
+
+
+ +
+

+ + #get_suggestions(word, language, max) ⇒ Array<String> + + + + + +

+
+ +

Returns suggestions for a misspelled word.

+ + +
+
+
+

Parameters:

+
    + +
  • + + word + + + (String) + + + + — +
    +

    The incorrect word that has to be determined for suggestions.

    +
    + +
  • + +
  • + + language + + + (String) + + + + — +
    +

    The language that is used to spell check the specified text.

    +
    + +
  • + +
  • + + max + + + (Integer) + + + + — +
    +

    The maximum number of suggestions that has to be determined.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Array<String>) + + + + — +
    +

    Suggestions for a misspelled word.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+424
+425
+426
+427
+428
+429
+430
+431
+432
+433
+434
+435
+436
+437
+438
+439
+440
+441
+442
+443
+444
+445
+446
+447
+448
+449
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 424
+
+def get_suggestions(word, language, max)
+  # Parameter validation
+  unless !word.nil? && !word.to_s.empty?
+    raise ArgumentError, "The given text must not be empty."
+  end        
+  unless !language.nil? && !language.to_s.empty?
+    raise ArgumentError, "A language must be defined."
+  end        
+  unless max.is_a? Integer 
+    raise ArgumentError, "max must be an integer"
+  end
+  
+  # Create query parameters
+  params = {
+    :word => word,
+    :language => language,
+    :max => max
+  }
+
+  res = request("/proofing/suggestions", :get, params)
+  if res.kind_of? Net::HTTPSuccess
+    return JSON.parse(res.body)
+  else
+    raise res.body
+  end        
+end
+
+
+ +
+

+ + #get_template_countInteger + + + + + +

+
+ +

Returns the number of templates in the template storage.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    The number of templates in the template storage.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+80
+81
+82
+83
+84
+85
+86
+87
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 80
+
+def get_template_count
+  res = request("/templates/count", :get)
+  if res.kind_of? Net::HTTPSuccess
+    return Integer(res.body)
+  else
+    raise res.body
+  end
+end
+
+
+ +
+

+ + #get_template_info(template_name) ⇒ TemplateInfo + + + + + +

+
+ +

Returns information about a template including merge fields and merge +blocks.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template in the template storage to retrieve the +information for.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (TemplateInfo) + + + + — +
    +

    The template information.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+316
+317
+318
+319
+320
+321
+322
+323
+324
+325
+326
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 316
+
+def get_template_info(template_name)
+  # Parameter validation
+  TemplateNameValidator.validate(template_name)
+
+  res = request("/templates/info", :get, { :templateName => template_name })
+  if res.kind_of? Net::HTTPSuccess
+    return TemplateInfo.from_camelized_hash(JSON.parse(res.body))
+  else
+    raise res.body
+  end
+end
+
+
+ +
+

+ + #get_template_page_count(template_name) ⇒ Integer + + + + + +

+
+ +

Returns the number of pages of a template in the template storage.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template in the template storage to retrieve the number +of pages for.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    The number of pages in the template.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+272
+273
+274
+275
+276
+277
+278
+279
+280
+281
+282
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 272
+
+def get_template_page_count(template_name)
+  # Parameter validation
+  TemplateNameValidator.validate(template_name)
+  
+  res = request("/templates/pagecount", :get, { :templateName => template_name })
+  if res.kind_of? Net::HTTPSuccess
+    return Integer(res.body)
+  else
+    raise res.body
+  end        
+end
+
+
+ +
+

+ + #get_template_thumbnails(template_name, zoom_factor, from_page = 1, to_page = 0, image_format = :png) ⇒ Array<String> + + + + + +

+
+ +

Returns a list of thumbnails of a specific template.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template in the template storage.

    +
    + +
  • + +
  • + + zoom_factor + + + (Integer) + + + + — +
    +

    An Integer value between 1 and 400 to set the +percentage zoom factor of the created thumbnail images.

    +
    + +
  • + +
  • + + from_page + + + (Integer) + + + (defaults to: 1) + + + — +
    +

    An Integer value that specifies the first page.

    +
    + +
  • + +
  • + + to_page + + + (Integer) + + + (defaults to: 0) + + + — +
    +

    An Integer value that specifies the last page.

    +
    + +
  • + +
  • + + image_format + + + (Symbol) + + + (defaults to: :png) + + + — +
    +

    Defines the image format of the returned thumbnails. Possible values are +:png, :jpg, :gif and +:bmp.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Array<String>) + + + + — +
    +

    An array of Base64 encoded images.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+178
+179
+180
+181
+182
+183
+184
+185
+186
+187
+188
+189
+190
+191
+192
+193
+194
+195
+196
+197
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 178
+
+def get_template_thumbnails(template_name, zoom_factor, from_page = 1, to_page = 0, image_format = :png)
+  # Prepare query parameters
+  params = {
+    :templateName => template_name,
+    :zoomFactor => zoom_factor,
+    :fromPage => from_page,
+    :toPage => to_page,
+  }
+  if image_format != :png
+    params[:imageFormat] = image_format 
+  end
+  
+  # Send request
+  res = request("/templates/thumbnails", :get, params)
+  if res.kind_of? Net::HTTPSuccess
+    return JSON.parse(res.body)
+  else
+    raise res.body
+  end        
+end
+
+
+ +
+

+ + #list_fontsArray<String> + + + + + +

+
+ +

Lists all available fonts.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<String>) + + + + — +
    +

    An array containing the names of all available fonts.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+366
+367
+368
+369
+370
+371
+372
+373
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 366
+
+def list_fonts
+  res = request("/fonts/list", :get)
+  if res.kind_of? Net::HTTPSuccess
+    return JSON.parse(res.body)
+  else
+    raise res.body
+  end        
+end
+
+
+ +
+

+ + #list_templatesArray<Template> + + + + + +

+
+ +

Lists all templates from the template storage.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<Template>) + + + + — +
    +

    An array of Template objects.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73
+74
+75
+76
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 64
+
+def list_templates
+  res = request("/templates/list", :get)
+  if res.kind_of? Net::HTTPSuccess
+    templates = Array.new
+    data = JSON.parse(res.body, object_class: OpenStruct)
+    data.each do |elem|
+      templates.push(Template.new(elem.templateName, elem.modified, elem.size))
+    end
+    return templates
+  else
+    raise res.body
+  end
+end
+
+
+ +
+

+ + #merge_document(merge_body, template_name = nil, return_format = :pdf, append = false, test = false) ⇒ Array<String> + + + + + +

+
+ +

Merges and returns a template from the template storage or an uploaded +template with JSON data.

+ + +
+
+
+

Parameters:

+
    + +
  • + + return_format + + + (Symbol) + + + (defaults to: :pdf) + + + — +
    +

    The format of the created document. Possible values are :pdf, +:rtf, :doc, :docx, +:html, :tx and :txt.

    +
    + +
  • + +
  • + + merge_body + + + (MergeBody) + + + + — +
    +

    The MergeBody object contains the datasource as a JSON data object and +optionally, a template encoded as a Base64 string.

    +
    + +
  • + +
  • + + template_name + + + (String) + + + (defaults to: nil) + + + — +
    +

    The name of the template in the template storage. If no template name is +specified, the template must be uploaded in the MergeBody object of this +request.

    +
    + +
  • + +
  • + + append + + + (Boolean) + + + (defaults to: false) + + + — +
    +

    Specifies whether the documents should be appened to one resulting +document when more than 1 data row is passed.

    +
    + +
  • + +
  • + + test + + + (Boolean) + + + (defaults to: false) + + + — +
    +

    Specifies whether it is a test run or not. A test run is not counted +against the quota and created documents contain a watermark.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Array<String>) + + + + — +
    +

    An array of the created documents as Base64 encoded strings.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+104
+105
+106
+107
+108
+109
+110
+111
+112
+113
+114
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
+126
+127
+128
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 104
+
+def merge_document(merge_body, template_name = nil, return_format = :pdf, append = false, test = false)
+  if !template_name.to_s.empty? && !merge_body.template.nil?   # .to_s.empty: check for nil or ''
+    raise ArgumentError, "Template name and template data must not be present at the same time."
+  elsif template_name.to_s.empty? && merge_body.template.nil?
+    raise ArgumentError, "Either a template name or template data have to be present."
+  end
+  
+  # Create query parameters
+  params = {
+    :returnFormat => return_format,
+    :append => append,
+    :test => test
+  }
+  unless template_name.to_s.empty? 
+    params[:templateName] = template_name
+  end
+  
+  # Send request
+  res = request("/document/merge", :post, params, merge_body)
+  if res.kind_of? Net::HTTPSuccess
+    return JSON.parse(res.body)
+  else
+    raise res.body 
+  end        
+end
+
+
+ +
+

+ + #template_exists?(template_name) ⇒ Boolean + + + + + +

+
+ +

Checks whether a template exists in the template storage.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template to be checked for availability in the +template storage.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + + — +
    +

    Returns if the template with the given name exists in the template storage.

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+250
+251
+252
+253
+254
+255
+256
+257
+258
+259
+260
+261
+262
+263
+264
+265
+266
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 250
+
+def template_exists?(template_name)
+  # Parameter validation
+  TemplateNameValidator.validate(template_name)
+
+  res = request("/templates/exists", :get, { :templateName => template_name })                       
+  if res.kind_of? Net::HTTPSuccess
+    case res.body
+      when "true"
+        return true
+      when "false"
+        return false
+      else raise "Unknown response value received." 
+    end
+  else
+    raise res.body
+  end
+end
+
+
+ +
+

+ + #upload_template(template_name, template_data) ⇒ void + + + + + +

+
+

This method returns an undefined value.

+

Stores an uploaded template in the template storage ( *.doc, *.docx, +*.rtf and *.tx)

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The filename of the template in the template storage. Existing files with +the same filename will be overwritten.

    +
    + +
  • + +
  • + + template_data + + + (String) + + + + — +
    +

    A document encoded as a Base64 string. The supported formats are DOC, +DOCX, RTF and TX.

    +
    + +
  • + +
+ + +
+ + + + +
+
+
+
+219
+220
+221
+222
+223
+224
+225
+226
+227
+228
+
+
# File 'lib/txtextcontrol/reportingcloud/reportingcloud.rb', line 219
+
+def upload_template(template_name, template_data)
+  # Parameter validation
+  TemplateNameValidator.validate(template_name)
+  TemplateDataValidator.validate(template_data)
+  
+  res = request("/templates/upload", :post, { :templateName => template_name }, template_data)
+  unless res.kind_of? Net::HTTPSuccess
+    raise res.body 
+  end        
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/Template.html b/TXTextControl/ReportingCloud/Template.html new file mode 100644 index 0000000..a1ab8df --- /dev/null +++ b/TXTextControl/ReportingCloud/Template.html @@ -0,0 +1,522 @@ + + + + + + + Class: TXTextControl::ReportingCloud::Template + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::Template + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/template.rb
+
+ +
+ +

Overview

+
+ +

Holds information about a template in the template storage.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(template_name, modified, size) ⇒ Template + + + + + +

+
+ +

Returns a new instance of Template

+ + +
+
+
+ + +
+ + + + +
+
+
+
+30
+31
+32
+33
+34
+35
+36
+37
+38
+
+
# File 'lib/txtextcontrol/reportingcloud/template.rb', line 30
+
+def initialize(template_name, modified, size)
+  @template_name = template_name
+  if modified.is_a?(DateTime)
+    @modified = modified
+  else
+    @modified = DateTime.iso8601(modified) 
+  end
+  @size = size
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #modifiedDateTime (readonly) + + + + + +

+
+ +

The date and time the template file was last modified.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (DateTime) + + + + — +
    +

    the current value of modified

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/template.rb', line 25
+
+def modified
+  @modified
+end
+
+
+ + + +
+

+ + #sizeInteger (readonly) + + + + + +

+
+ +

The size of the template file in bytes.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Integer) + + + + — +
    +

    the current value of size

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/template.rb', line 25
+
+def size
+  @size
+end
+
+
+ + + +
+

+ + #template_nameString (readonly) + + + + + +

+
+ +

The template file name.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of template_name

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/template.rb', line 25
+
+def template_name
+  @template_name
+end
+
+
+ +
+ + +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/TemplateDataValidator.html b/TXTextControl/ReportingCloud/TemplateDataValidator.html new file mode 100644 index 0000000..0679c09 --- /dev/null +++ b/TXTextControl/ReportingCloud/TemplateDataValidator.html @@ -0,0 +1,278 @@ + + + + + + + Class: TXTextControl::ReportingCloud::TemplateDataValidator + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::TemplateDataValidator + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/template_data_validator.rb
+
+ +
+ +

Overview

+
+ +

Internal method parameter validator class.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + + + + + +

+ Class Method Summary + collapse +

+ + + + + + +
+

Class Method Details

+ + +
+

+ + .validate(template_data) ⇒ Boolean + + + + + +

+
+ +

Checks if a given value is a String, is not nil and not empty.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_data + + + (String) + + + + — +
    +

    The string to validate.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + +
  • + +
+

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+24
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/template_data_validator.rb', line 24
+
+def self.validate(template_data)
+  raise ArgumentError, "Template data must be a Base64 encoded string." if !template_data.kind_of? String
+  raise ArgumentError, "No template data given." if template_data.to_s.empty?
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/TemplateInfo.html b/TXTextControl/ReportingCloud/TemplateInfo.html new file mode 100644 index 0000000..570d9c3 --- /dev/null +++ b/TXTextControl/ReportingCloud/TemplateInfo.html @@ -0,0 +1,746 @@ + + + + + + + Class: TXTextControl::ReportingCloud::TemplateInfo + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::TemplateInfo + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/template_info.rb
+
+ +
+ +

Overview

+
+ +

Holds information about the merge blocks and merge fields in a template

+ +
in the template storage.
+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + +

Instance Attribute Summary collapse

+ + + + + + +

+ Class Method Summary + collapse +

+ + + +

+ Instance Method Summary + collapse +

+ + + + +
+

Constructor Details

+ +
+

+ + #initialize(template_name, merge_blocks, merge_fields) ⇒ TemplateInfo + + + + + +

+
+ +

Returns a new instance of TemplateInfo

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The template file name.

    +
    + +
  • + +
  • + + merge_blocks + + + (Array<MergeBlock>) + + + + — +
    +

    The top level merge blocks in the template.

    +
    + +
  • + +
  • + + merge_fields + + + (Array<MergeField>) + + + + — +
    +

    The top level merge fields in the template.

    +
    + +
  • + +
+ +

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+
+
# File 'lib/txtextcontrol/reportingcloud/template_info.rb', line 36
+
+def initialize(template_name, merge_blocks, merge_fields)
+  # Parameter validation
+  raise ArgumentError, "Block name must be a string." if !template_name.kind_of? String
+  raise ArgumentError, "Parameter merge_blocks must be an array." if !merge_blocks.kind_of? Array
+  raise ArgumentError, "Parameter merge_fields must be an array." if !merge_fields.kind_of? Array
+
+  @template_name = template_name
+  @merge_blocks = merge_blocks
+  @merge_fields = merge_fields
+end
+
+
+ +
+ +
+

Instance Attribute Details

+ + + +
+

+ + #merge_blocksArray<MergeBlock> (readonly) + + + + + +

+
+ +

Contains all top level merge blocks in the template.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<MergeBlock>) + + + + — +
    +

    the current value of merge_blocks

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/template_info.rb', line 28
+
+def merge_blocks
+  @merge_blocks
+end
+
+
+ + + +
+

+ + #merge_fieldsArray<MergeField> (readonly) + + + + + +

+
+ +

Contains all top level merge fields in the template.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (Array<MergeField>) + + + + — +
    +

    the current value of merge_fields

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/template_info.rb', line 28
+
+def merge_fields
+  @merge_fields
+end
+
+
+ + + +
+

+ + #template_nameString (readonly) + + + + + +

+
+ +

The template file name.

+ + +
+
+
+ +

Returns:

+
    + +
  • + + + (String) + + + + — +
    +

    the current value of template_name

    +
    + +
  • + +
+ +
+ + + + +
+
+
+
+28
+29
+30
+
+
# File 'lib/txtextcontrol/reportingcloud/template_info.rb', line 28
+
+def template_name
+  @template_name
+end
+
+
+ +
+ + +
+

Class Method Details

+ + +
+

+ + .from_camelized_hash(hash) ⇒ TemplateInfo + + + + + +

+
+ +

Creates a TemplateInfo instance from a hash.

+ + +
+
+
+

Parameters:

+
    + +
  • + + hash + + + (Hash) + + + + — +
    +

    The hash to try and create a TemplateInfo instance from.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (TemplateInfo) + + + + — +
    +

    A newly created TemplateInfo instance.

    +
    + +
  • + +
+

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+
+
# File 'lib/txtextcontrol/reportingcloud/template_info.rb', line 50
+
+def self.from_camelized_hash(hash)
+  # Parameter validation
+  raise ArgumentError, "Parameter must be a Hash." if !hash.kind_of? Hash
+
+  name = hash["templateName"]
+  blocks = Array.new
+  hash["mergeBlocks"].each do |elem|
+    blocks.push(MergeBlock.from_camelized_hash(elem))
+  end
+  fields = Array.new 
+  hash["mergeFields"].each do |elem|
+    fields.push(MergeField.from_camelized_hash(elem))
+  end
+  return TemplateInfo.new(name, blocks, fields)
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/TXTextControl/ReportingCloud/TemplateNameValidator.html b/TXTextControl/ReportingCloud/TemplateNameValidator.html new file mode 100644 index 0000000..1b9beaa --- /dev/null +++ b/TXTextControl/ReportingCloud/TemplateNameValidator.html @@ -0,0 +1,278 @@ + + + + + + + Class: TXTextControl::ReportingCloud::TemplateNameValidator + + — Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Class: TXTextControl::ReportingCloud::TemplateNameValidator + + + +

+
+ +
+
Inherits:
+
+ Object + +
    +
  • Object
  • + + + +
+ show all + +
+
+ + + + + + + + + + + +
+
Defined in:
+
lib/txtextcontrol/reportingcloud/template_name_validator.rb
+
+ +
+ +

Overview

+
+ +

Internal method parameter validator class.

+ + +
+
+
+ +

Author:

+
    + +
  • + + + + + +
    +

    Thorsten Kummerow (@thomerow)

    +
    + +
  • + +
+ +
+ + + + + + + +

+ Class Method Summary + collapse +

+ + + + + + +
+

Class Method Details

+ + +
+

+ + .validate(template_name) ⇒ Boolean + + + + + +

+
+ +

Checks if a given value is a String, is not nil and not empty.

+ + +
+
+
+

Parameters:

+
    + +
  • + + template_name + + + (String) + + + + — +
    +

    The string to validate.

    +
    + +
  • + +
+ +

Returns:

+
    + +
  • + + + (Boolean) + + + +
  • + +
+

Raises:

+
    + +
  • + + + (ArgumentError) + + + +
  • + +
+ +
+ + + + +
+
+
+
+24
+25
+26
+27
+
+
# File 'lib/txtextcontrol/reportingcloud/template_name_validator.rb', line 24
+
+def self.validate(template_name)
+  raise ArgumentError, "Template name must be a String." if !template_name.kind_of? String 
+  raise ArgumentError, "No template name given." if template_name.to_s.empty?
+end
+
+
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/_index.html b/_index.html new file mode 100644 index 0000000..9daee55 --- /dev/null +++ b/_index.html @@ -0,0 +1,290 @@ + + + + + + + Documentation by YARD 0.9.8 + + + + + + + + + + + + + + + + + + + +
+ + +

Documentation by YARD 0.9.8

+
+

Alphabetic Index

+ +

File Listing

+ + +
+

Namespace Listing A-Z

+ + + + + + + + +
+ + +
    +
  • A
  • +
      + +
    • + APIKey + + (TXTextControl::ReportingCloud) + +
    • + +
    • + AccountSettings + + (TXTextControl::ReportingCloud) + +
    • + +
    • + AppendBody + + (TXTextControl::ReportingCloud) + +
    • + +
    • + AppendDocument + + (TXTextControl::ReportingCloud) + +
    • + +
    +
+ + + + + + + + +
    +
  • I
  • +
      + +
    • + IncorrectWord + + (TXTextControl::ReportingCloud) + +
    • + +
    +
+ + +
    +
  • M
  • +
      + +
    • + MergeBlock + + (TXTextControl::ReportingCloud) + +
    • + +
    • + MergeBody + + (TXTextControl::ReportingCloud) + +
    • + +
    • + MergeField + + (TXTextControl::ReportingCloud) + +
    • + +
    • + MergeSettings + + (TXTextControl::ReportingCloud) + +
    • + +
    +
+ + + + + +
    +
  • S
  • + +
+ + +
+ + + + +
+ +
+ +
+ + + +
+ + \ No newline at end of file diff --git a/bin/console b/bin/console deleted file mode 100644 index bb5a86d..0000000 --- a/bin/console +++ /dev/null @@ -1,14 +0,0 @@ -#!/usr/bin/env ruby - -require "bundler/setup" -require "txtextcontrol/reportingcloud" - -# You can add fixtures and/or initialization code here to make experimenting -# with your gem easier. You can also use a different console, if you like. - -# (If you use this, don't forget to add pry to your Gemfile!) -# require "pry" -# Pry.start - -require "irb" -IRB.start diff --git a/bin/setup b/bin/setup deleted file mode 100644 index 5ffb724..0000000 --- a/bin/setup +++ /dev/null @@ -1,8 +0,0 @@ -#!/usr/bin/env bash -set -euo pipefail -IFS=$'\n\t' -set -vx - -bundle install - -# Do any other automated setup that you need to do here diff --git a/class_list.html b/class_list.html new file mode 100644 index 0000000..1290191 --- /dev/null +++ b/class_list.html @@ -0,0 +1,51 @@ + + + + + + + + + + + + + + + + + + Class List + + + +
+
+

Class List

+ + + +
+ + +
+ + diff --git a/css/common.css b/css/common.css new file mode 100644 index 0000000..cf25c45 --- /dev/null +++ b/css/common.css @@ -0,0 +1 @@ +/* Override this file with custom rules */ \ No newline at end of file diff --git a/css/full_list.css b/css/full_list.css new file mode 100644 index 0000000..fa35982 --- /dev/null +++ b/css/full_list.css @@ -0,0 +1,58 @@ +body { + margin: 0; + font-family: "Lucida Sans", "Lucida Grande", Verdana, Arial, sans-serif; + font-size: 13px; + height: 101%; + overflow-x: hidden; + background: #fafafa; +} + +h1 { padding: 12px 10px; padding-bottom: 0; margin: 0; font-size: 1.4em; } +.clear { clear: both; } +.fixed_header { position: fixed; background: #fff; width: 100%; padding-bottom: 10px; margin-top: 0; top: 0; z-index: 9999; height: 70px; } +#search { position: absolute; right: 5px; top: 9px; padding-left: 24px; } +#content.insearch #search, #content.insearch #noresults { background: url(data:image/gif;base64,R0lGODlhEAAQAPYAAP///wAAAPr6+pKSkoiIiO7u7sjIyNjY2J6engAAAI6OjsbGxjIyMlJSUuzs7KamppSUlPLy8oKCghwcHLKysqSkpJqamvT09Pj4+KioqM7OzkRERAwMDGBgYN7e3ujo6Ly8vCoqKjY2NkZGRtTU1MTExDw8PE5OTj4+PkhISNDQ0MrKylpaWrS0tOrq6nBwcKysrLi4uLq6ul5eXlxcXGJiYoaGhuDg4H5+fvz8/KKiohgYGCwsLFZWVgQEBFBQUMzMzDg4OFhYWBoaGvDw8NbW1pycnOLi4ubm5kBAQKqqqiQkJCAgIK6urnJyckpKSjQ0NGpqatLS0sDAwCYmJnx8fEJCQlRUVAoKCggICLCwsOTk5ExMTPb29ra2tmZmZmhoaNzc3KCgoBISEiIiIgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH/C05FVFNDQVBFMi4wAwEAAAAh/hpDcmVhdGVkIHdpdGggYWpheGxvYWQuaW5mbwAh+QQJCAAAACwAAAAAEAAQAAAHaIAAgoMgIiYlg4kACxIaACEJCSiKggYMCRselwkpghGJBJEcFgsjJyoAGBmfggcNEx0flBiKDhQFlIoCCA+5lAORFb4AJIihCRbDxQAFChAXw9HSqb60iREZ1omqrIPdJCTe0SWI09GBACH5BAkIAAAALAAAAAAQABAAAAdrgACCgwc0NTeDiYozCQkvOTo9GTmDKy8aFy+NOBA7CTswgywJDTIuEjYFIY0JNYMtKTEFiRU8Pjwygy4ws4owPyCKwsMAJSTEgiQlgsbIAMrO0dKDGMTViREZ14kYGRGK38nHguHEJcvTyIEAIfkECQgAAAAsAAAAABAAEAAAB2iAAIKDAggPg4iJAAMJCRUAJRIqiRGCBI0WQEEJJkWDERkYAAUKEBc4Po1GiKKJHkJDNEeKig4URLS0ICImJZAkuQAhjSi/wQyNKcGDCyMnk8u5rYrTgqDVghgZlYjcACTA1sslvtHRgQAh+QQJCAAAACwAAAAAEAAQAAAHZ4AAgoOEhYaCJSWHgxGDJCQARAtOUoQRGRiFD0kJUYWZhUhKT1OLhR8wBaaFBzQ1NwAlkIszCQkvsbOHL7Y4q4IuEjaqq0ZQD5+GEEsJTDCMmIUhtgk1lo6QFUwJVDKLiYJNUd6/hoEAIfkECQgAAAAsAAAAABAAEAAAB2iAAIKDhIWGgiUlh4MRgyQkjIURGRiGGBmNhJWHm4uen4ICCA+IkIsDCQkVACWmhwSpFqAABQoQF6ALTkWFnYMrVlhWvIKTlSAiJiVVPqlGhJkhqShHV1lCW4cMqSkAR1ofiwsjJyqGgQAh+QQJCAAAACwAAAAAEAAQAAAHZ4AAgoOEhYaCJSWHgxGDJCSMhREZGIYYGY2ElYebi56fhyWQniSKAKKfpaCLFlAPhl0gXYNGEwkhGYREUywag1wJwSkHNDU3D0kJYIMZQwk8MjPBLx9eXwuETVEyAC/BOKsuEjYFhoEAIfkECQgAAAAsAAAAABAAEAAAB2eAAIKDhIWGgiUlh4MRgyQkjIURGRiGGBmNhJWHm4ueICImip6CIQkJKJ4kigynKaqKCyMnKqSEK05StgAGQRxPYZaENqccFgIID4KXmQBhXFkzDgOnFYLNgltaSAAEpxa7BQoQF4aBACH5BAkIAAAALAAAAAAQABAAAAdogACCg4SFggJiPUqCJSWGgkZjCUwZACQkgxGEXAmdT4UYGZqCGWQ+IjKGGIUwPzGPhAc0NTewhDOdL7Ykji+dOLuOLhI2BbaFETICx4MlQitdqoUsCQ2vhKGjglNfU0SWmILaj43M5oEAOwAAAAAAAAAAAA==) no-repeat center left; } +#full_list { padding: 0; list-style: none; margin-left: 0; margin-top: 80px; font-size: 1.1em; } +#full_list ul { padding: 0; } +#full_list li { padding: 0; margin: 0; list-style: none; } +#full_list li .item { padding: 5px 5px 5px 12px; } +#noresults { padding: 7px 12px; background: #fff; } +#content.insearch #noresults { margin-left: 7px; } +li.collapsed ul { display: none; } +li a.toggle { cursor: default; position: relative; left: -5px; top: 4px; text-indent: -999px; width: 10px; height: 9px; margin-left: -10px; display: block; float: left; background: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAASCAYAAABb0P4QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAK8AAACvABQqw0mAAAABx0RVh0U29mdHdhcmUAQWRvYmUgRmlyZXdvcmtzIENTM5jWRgMAAAAVdEVYdENyZWF0aW9uIFRpbWUAMy8xNC8wOeNZPpQAAAE2SURBVDiNrZTBccIwEEXfelIAHUA6CZ24BGaWO+FuzZAK4k6gg5QAdGAq+Bxs2Yqx7BzyL7Llp/VfzZeQhCTc/ezuGzKKnKSzpCxXJM8fwNXda3df5RZETlIt6YUzSQDs93sl8w3wBZxCCE10GM1OcWbWjB2mWgEH4Mfdyxm3PSepBHibgQE2wLe7r4HjEidpnXMYdQPKEMJcsZ4zs2POYQOcaPfwMVOo58zsAdMt18BuoVDPxUJRacELbXv3hUIX2vYmOUvi8C8ydz/ThjXrqKqqLbDIAdsCKBd+Wo7GWa7o9qzOQHVVVXeAbs+yHHCH4aTsaCOQqunmUy1yBUAXkdMIfMlgF5EXLo2OpV/c/Up7jG4hhHcYLgWzAZXUc2b2ixsfvc/RmNNfOXD3Q/oeL9axJE1yT9IOoUu6MGUkAAAAAElFTkSuQmCC) no-repeat bottom left; } +li.collapsed a.toggle { opacity: 0.5; cursor: default; background-position: top left; } +li { color: #888; cursor: pointer; } +li.deprecated { text-decoration: line-through; font-style: italic; } +li.odd { background: #f0f0f0; } +li.even { background: #fafafa; } +.item:hover { background: #ddd; } +li small:before { content: "("; } +li small:after { content: ")"; } +li small.search_info { display: none; } +a, a:visited { text-decoration: none; color: #05a; } +li.clicked > .item { background: #05a; color: #ccc; } +li.clicked > .item a, li.clicked > .item a:visited { color: #eee; } +li.clicked > .item a.toggle { opacity: 0.5; background-position: bottom right; } +li.collapsed.clicked a.toggle { background-position: top right; } +#search input { border: 1px solid #bbb; border-radius: 3px; } +#full_list_nav { margin-left: 10px; font-size: 0.9em; display: block; color: #aaa; } +#full_list_nav a, #nav a:visited { color: #358; } +#full_list_nav a:hover { background: transparent; color: #5af; } +#full_list_nav span:after { content: ' | '; } +#full_list_nav span:last-child:after { content: ''; } + +#content h1 { margin-top: 0; } +li { white-space: nowrap; cursor: normal; } +li small { display: block; font-size: 0.8em; } +li small:before { content: ""; } +li small:after { content: ""; } +li small.search_info { display: none; } +#search { width: 170px; position: static; margin: 3px; margin-left: 10px; font-size: 0.9em; color: #888; padding-left: 0; padding-right: 24px; } +#content.insearch #search { background-position: center right; } +#search input { width: 110px; } + +#full_list.insearch ul { display: block; } +#full_list.insearch .item { display: none; } +#full_list.insearch .found { display: block; padding-left: 11px !important; } +#full_list.insearch li a.toggle { display: none; } +#full_list.insearch li small.search_info { display: block; } diff --git a/css/style.css b/css/style.css new file mode 100644 index 0000000..f682a69 --- /dev/null +++ b/css/style.css @@ -0,0 +1,492 @@ +html { + width: 100%; + height: 100%; +} +body { + font-family: "Lucida Sans", "Lucida Grande", Verdana, Arial, sans-serif; + font-size: 13px; + width: 100%; + margin: 0; + padding: 0; + display: flex; + display: -webkit-flex; + display: -ms-flexbox; +} + +#nav { + position: relative; + width: 100%; + height: 100%; + border: 0; + border-right: 1px dotted #eee; + overflow: auto; +} +.nav_wrap { + margin: 0; + padding: 0; + width: 20%; + height: 100%; + position: relative; + display: flex; + display: -webkit-flex; + display: -ms-flexbox; + flex-shrink: 0; + -webkit-flex-shrink: 0; + -ms-flex: 1 0; +} +#resizer { + position: absolute; + right: -5px; + top: 0; + width: 10px; + height: 100%; + cursor: col-resize; + z-index: 9999; +} +#main { + flex: 5 1; + -webkit-flex: 5 1; + -ms-flex: 5 1; + outline: none; + position: relative; + background: #fff; + padding: 1.2em; + padding-top: 0.2em; +} + +@media (max-width: 920px) { + .nav_wrap { width: 100%; top: 0; right: 0; overflow: visible; position: absolute; } + #resizer { display: none; } + #nav { + z-index: 9999; + background: #fff; + display: none; + position: absolute; + top: 40px; + right: 12px; + width: 500px; + max-width: 80%; + height: 80%; + overflow-y: scroll; + border: 1px solid #999; + border-collapse: collapse; + box-shadow: -7px 5px 25px #aaa; + border-radius: 2px; + } +} + +@media (min-width: 920px) { + body { height: 100%; overflow: hidden; } + #main { height: 100%; overflow: auto; } + #search { display: none; } +} + +#main img { max-width: 100%; } +h1 { font-size: 25px; margin: 1em 0 0.5em; padding-top: 4px; border-top: 1px dotted #d5d5d5; } +h1.noborder { border-top: 0px; margin-top: 0; padding-top: 4px; } +h1.title { margin-bottom: 10px; } +h1.alphaindex { margin-top: 0; font-size: 22px; } +h2 { + padding: 0; + padding-bottom: 3px; + border-bottom: 1px #aaa solid; + font-size: 1.4em; + margin: 1.8em 0 0.5em; + position: relative; +} +h2 small { font-weight: normal; font-size: 0.7em; display: inline; position: absolute; right: 0; } +h2 small a { + display: block; + height: 20px; + border: 1px solid #aaa; + border-bottom: 0; + border-top-left-radius: 5px; + background: #f8f8f8; + position: relative; + padding: 2px 7px; +} +.clear { clear: both; } +.inline { display: inline; } +.inline p:first-child { display: inline; } +.docstring, .tags, #filecontents { font-size: 15px; line-height: 1.5145em; } +.docstring p > code, .docstring p > tt, .tags p > code, .tags p > tt { + color: #c7254e; background: #f9f2f4; padding: 2px 4px; font-size: 1em; + border-radius: 4px; +} +.docstring h1, .docstring h2, .docstring h3, .docstring h4 { padding: 0; border: 0; border-bottom: 1px dotted #bbb; } +.docstring h1 { font-size: 1.2em; } +.docstring h2 { font-size: 1.1em; } +.docstring h3, .docstring h4 { font-size: 1em; border-bottom: 0; padding-top: 10px; } +.summary_desc .object_link a, .docstring .object_link a { + font-family: monospace; font-size: 1.05em; + color: #05a; background: #EDF4FA; padding: 2px 4px; font-size: 1em; + border-radius: 4px; +} +.rdoc-term { padding-right: 25px; font-weight: bold; } +.rdoc-list p { margin: 0; padding: 0; margin-bottom: 4px; } +.summary_desc pre.code .object_link a, .docstring pre.code .object_link a { + padding: 0px; background: inherit; color: inherit; border-radius: inherit; +} + +/* style for */ +#filecontents table, .docstring table { border-collapse: collapse; } +#filecontents table th, #filecontents table td, +.docstring table th, .docstring table td { border: 1px solid #ccc; padding: 8px; padding-right: 17px; } +#filecontents table tr:nth-child(odd), +.docstring table tr:nth-child(odd) { background: #eee; } +#filecontents table tr:nth-child(even), +.docstring table tr:nth-child(even) { background: #fff; } +#filecontents table th, .docstring table th { background: #fff; } + +/* style for
a",d=q.getElementsByTagName("*"),e=q.getElementsByTagName("a")[0];if(!d||!d.length||!e)return{};g=c.createElement("select"),h=g.appendChild(c.createElement("option")),i=q.getElementsByTagName("input")[0],b={leadingWhitespace:q.firstChild.nodeType===3,tbody:!q.getElementsByTagName("tbody").length,htmlSerialize:!!q.getElementsByTagName("link").length,style:/top/.test(e.getAttribute("style")),hrefNormalized:e.getAttribute("href")==="/a",opacity:/^0.55/.test(e.style.opacity),cssFloat:!!e.style.cssFloat,checkOn:i.value==="on",optSelected:h.selected,getSetAttribute:q.className!=="t",enctype:!!c.createElement("form").enctype,html5Clone:c.createElement("nav").cloneNode(!0).outerHTML!=="<:nav>",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0},i.checked=!0,b.noCloneChecked=i.cloneNode(!0).checked,g.disabled=!0,b.optDisabled=!h.disabled;try{delete q.test}catch(s){b.deleteExpando=!1}!q.addEventListener&&q.attachEvent&&q.fireEvent&&(q.attachEvent("onclick",function(){b.noCloneEvent=!1}),q.cloneNode(!0).fireEvent("onclick")),i=c.createElement("input"),i.value="t",i.setAttribute("type","radio"),b.radioValue=i.value==="t",i.setAttribute("checked","checked"),q.appendChild(i),k=c.createDocumentFragment(),k.appendChild(q.lastChild),b.checkClone=k.cloneNode(!0).cloneNode(!0).lastChild.checked,b.appendChecked=i.checked,k.removeChild(i),k.appendChild(q),q.innerHTML="",a.getComputedStyle&&(j=c.createElement("div"),j.style.width="0",j.style.marginRight="0",q.style.width="2px",q.appendChild(j),b.reliableMarginRight=(parseInt((a.getComputedStyle(j,null)||{marginRight:0}).marginRight,10)||0)===0);if(q.attachEvent)for(o in{submit:1,change:1,focusin:1})n="on"+o,p=n in q,p||(q.setAttribute(n,"return;"),p=typeof q[n]=="function"),b[o+"Bubbles"]=p;k.removeChild(q),k=g=h=j=q=i=null,f(function(){var a,d,e,g,h,i,j,k,m,n,o,r=c.getElementsByTagName("body")[0];!r||(j=1,k="position:absolute;top:0;left:0;width:1px;height:1px;margin:0;",m="visibility:hidden;border:0;",n="style='"+k+"border:5px solid #000;padding:0;'",o="
"+""+"
",a=c.createElement("div"),a.style.cssText=m+"width:0;height:0;position:static;top:0;margin-top:"+j+"px",r.insertBefore(a,r.firstChild),q=c.createElement("div"),a.appendChild(q),q.innerHTML="
t
",l=q.getElementsByTagName("td"),p=l[0].offsetHeight===0,l[0].style.display="",l[1].style.display="none",b.reliableHiddenOffsets=p&&l[0].offsetHeight===0,q.innerHTML="",q.style.width=q.style.paddingLeft="1px",f.boxModel=b.boxModel=q.offsetWidth===2,typeof q.style.zoom!="undefined"&&(q.style.display="inline",q.style.zoom=1,b.inlineBlockNeedsLayout=q.offsetWidth===2,q.style.display="",q.innerHTML="
",b.shrinkWrapBlocks=q.offsetWidth!==2),q.style.cssText=k+m,q.innerHTML=o,d=q.firstChild,e=d.firstChild,h=d.nextSibling.firstChild.firstChild,i={doesNotAddBorder:e.offsetTop!==5,doesAddBorderForTableAndCells:h.offsetTop===5},e.style.position="fixed",e.style.top="20px",i.fixedPosition=e.offsetTop===20||e.offsetTop===15,e.style.position=e.style.top="",d.style.overflow="hidden",d.style.position="relative",i.subtractsBorderForOverflowNotVisible=e.offsetTop===-5,i.doesNotIncludeMarginInBodyOffset=r.offsetTop!==j,r.removeChild(a),q=a=null,f.extend(b,i))});return b}();var j=/^(?:\{.*\}|\[.*\])$/,k=/([A-Z])/g;f.extend({cache:{},uuid:0,expando:"jQuery"+(f.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(a){a=a.nodeType?f.cache[a[f.expando]]:a[f.expando];return!!a&&!m(a)},data:function(a,c,d,e){if(!!f.acceptData(a)){var g,h,i,j=f.expando,k=typeof c=="string",l=a.nodeType,m=l?f.cache:a,n=l?a[j]:a[j]&&j,o=c==="events";if((!n||!m[n]||!o&&!e&&!m[n].data)&&k&&d===b)return;n||(l?a[j]=n=++f.uuid:n=j),m[n]||(m[n]={},l||(m[n].toJSON=f.noop));if(typeof c=="object"||typeof c=="function")e?m[n]=f.extend(m[n],c):m[n].data=f.extend(m[n].data,c);g=h=m[n],e||(h.data||(h.data={}),h=h.data),d!==b&&(h[f.camelCase(c)]=d);if(o&&!h[c])return g.events;k?(i=h[c],i==null&&(i=h[f.camelCase(c)])):i=h;return i}},removeData:function(a,b,c){if(!!f.acceptData(a)){var d,e,g,h=f.expando,i=a.nodeType,j=i?f.cache:a,k=i?a[h]:h;if(!j[k])return;if(b){d=c?j[k]:j[k].data;if(d){f.isArray(b)||(b in d?b=[b]:(b=f.camelCase(b),b in d?b=[b]:b=b.split(" ")));for(e=0,g=b.length;e-1)return!0;return!1},val:function(a){var c,d,e,g=this[0];{if(!!arguments.length){e=f.isFunction(a);return this.each(function(d){var g=f(this),h;if(this.nodeType===1){e?h=a.call(this,d,g.val()):h=a,h==null?h="":typeof h=="number"?h+="":f.isArray(h)&&(h=f.map(h,function(a){return a==null?"":a+""})),c=f.valHooks[this.nodeName.toLowerCase()]||f.valHooks[this.type];if(!c||!("set"in c)||c.set(this,h,"value")===b)this.value=h}})}if(g){c=f.valHooks[g.nodeName.toLowerCase()]||f.valHooks[g.type];if(c&&"get"in c&&(d=c.get(g,"value"))!==b)return d;d=g.value;return typeof d=="string"?d.replace(q,""):d==null?"":d}}}}),f.extend({valHooks:{option:{get:function(a){var b=a.attributes.value;return!b||b.specified?a.value:a.text}},select:{get:function(a){var b,c,d,e,g=a.selectedIndex,h=[],i=a.options,j=a.type==="select-one";if(g<0)return null;c=j?g:0,d=j?g+1:i.length;for(;c=0}),c.length||(a.selectedIndex=-1);return c}}},attrFn:{val:!0,css:!0,html:!0,text:!0,data:!0,width:!0,height:!0,offset:!0},attr:function(a,c,d,e){var g,h,i,j=a.nodeType;if(!!a&&j!==3&&j!==8&&j!==2){if(e&&c in f.attrFn)return f(a)[c](d);if(typeof a.getAttribute=="undefined")return f.prop(a,c,d);i=j!==1||!f.isXMLDoc(a),i&&(c=c.toLowerCase(),h=f.attrHooks[c]||(u.test(c)?x:w));if(d!==b){if(d===null){f.removeAttr(a,c);return}if(h&&"set"in h&&i&&(g=h.set(a,d,c))!==b)return g;a.setAttribute(c,""+d);return d}if(h&&"get"in h&&i&&(g=h.get(a,c))!==null)return g;g=a.getAttribute(c);return g===null?b:g}},removeAttr:function(a,b){var c,d,e,g,h=0;if(b&&a.nodeType===1){d=b.toLowerCase().split(p),g=d.length;for(;h=0}})});var z=/^(?:textarea|input|select)$/i,A=/^([^\.]*)?(?:\.(.+))?$/,B=/\bhover(\.\S+)?\b/,C=/^key/,D=/^(?:mouse|contextmenu)|click/,E=/^(?:focusinfocus|focusoutblur)$/,F=/^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/,G=function(a){var b=F.exec(a);b&&(b[1]=(b[1]||"").toLowerCase(),b[3]=b[3]&&new RegExp("(?:^|\\s)"+b[3]+"(?:\\s|$)"));return b},H=function(a,b){var c=a.attributes||{};return(!b[1]||a.nodeName.toLowerCase()===b[1])&&(!b[2]||(c.id||{}).value===b[2])&&(!b[3]||b[3].test((c["class"]||{}).value))},I=function(a){return f.event.special.hover?a:a.replace(B,"mouseenter$1 mouseleave$1")}; +f.event={add:function(a,c,d,e,g){var h,i,j,k,l,m,n,o,p,q,r,s;if(!(a.nodeType===3||a.nodeType===8||!c||!d||!(h=f._data(a)))){d.handler&&(p=d,d=p.handler),d.guid||(d.guid=f.guid++),j=h.events,j||(h.events=j={}),i=h.handle,i||(h.handle=i=function(a){return typeof f!="undefined"&&(!a||f.event.triggered!==a.type)?f.event.dispatch.apply(i.elem,arguments):b},i.elem=a),c=f.trim(I(c)).split(" ");for(k=0;k=0&&(h=h.slice(0,-1),k=!0),h.indexOf(".")>=0&&(i=h.split("."),h=i.shift(),i.sort());if((!e||f.event.customEvent[h])&&!f.event.global[h])return;c=typeof c=="object"?c[f.expando]?c:new f.Event(h,c):new f.Event(h),c.type=h,c.isTrigger=!0,c.exclusive=k,c.namespace=i.join("."),c.namespace_re=c.namespace?new RegExp("(^|\\.)"+i.join("\\.(?:.*\\.)?")+"(\\.|$)"):null,o=h.indexOf(":")<0?"on"+h:"";if(!e){j=f.cache;for(l in j)j[l].events&&j[l].events[h]&&f.event.trigger(c,d,j[l].handle.elem,!0);return}c.result=b,c.target||(c.target=e),d=d!=null?f.makeArray(d):[],d.unshift(c),p=f.event.special[h]||{};if(p.trigger&&p.trigger.apply(e,d)===!1)return;r=[[e,p.bindType||h]];if(!g&&!p.noBubble&&!f.isWindow(e)){s=p.delegateType||h,m=E.test(s+h)?e:e.parentNode,n=null;for(;m;m=m.parentNode)r.push([m,s]),n=m;n&&n===e.ownerDocument&&r.push([n.defaultView||n.parentWindow||a,s])}for(l=0;le&&i.push({elem:this,matches:d.slice(e)});for(j=0;j0?this.on(b,null,a,c):this.trigger(b)},f.attrFn&&(f.attrFn[b]=!0),C.test(b)&&(f.event.fixHooks[b]=f.event.keyHooks),D.test(b)&&(f.event.fixHooks[b]=f.event.mouseHooks)}),function(){function x(a,b,c,e,f,g){for(var h=0,i=e.length;h0){k=j;break}}j=j[a]}e[h]=k}}}function w(a,b,c,e,f,g){for(var h=0,i=e.length;h+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,d="sizcache"+(Math.random()+"").replace(".",""),e=0,g=Object.prototype.toString,h=!1,i=!0,j=/\\/g,k=/\r\n/g,l=/\W/;[0,0].sort(function(){i=!1;return 0});var m=function(b,d,e,f){e=e||[],d=d||c;var h=d;if(d.nodeType!==1&&d.nodeType!==9)return[];if(!b||typeof b!="string")return e;var i,j,k,l,n,q,r,t,u=!0,v=m.isXML(d),w=[],x=b;do{a.exec(""),i=a.exec(x);if(i){x=i[3],w.push(i[1]);if(i[2]){l=i[3];break}}}while(i);if(w.length>1&&p.exec(b))if(w.length===2&&o.relative[w[0]])j=y(w[0]+w[1],d,f);else{j=o.relative[w[0]]?[d]:m(w.shift(),d);while(w.length)b=w.shift(),o.relative[b]&&(b+=w.shift()),j=y(b,j,f)}else{!f&&w.length>1&&d.nodeType===9&&!v&&o.match.ID.test(w[0])&&!o.match.ID.test(w[w.length-1])&&(n=m.find(w.shift(),d,v),d=n.expr?m.filter(n.expr,n.set)[0]:n.set[0]);if(d){n=f?{expr:w.pop(),set:s(f)}:m.find(w.pop(),w.length===1&&(w[0]==="~"||w[0]==="+")&&d.parentNode?d.parentNode:d,v),j=n.expr?m.filter(n.expr,n.set):n.set,w.length>0?k=s(j):u=!1;while(w.length)q=w.pop(),r=q,o.relative[q]?r=w.pop():q="",r==null&&(r=d),o.relative[q](k,r,v)}else k=w=[]}k||(k=j),k||m.error(q||b);if(g.call(k)==="[object Array]")if(!u)e.push.apply(e,k);else if(d&&d.nodeType===1)for(t=0;k[t]!=null;t++)k[t]&&(k[t]===!0||k[t].nodeType===1&&m.contains(d,k[t]))&&e.push(j[t]);else for(t=0;k[t]!=null;t++)k[t]&&k[t].nodeType===1&&e.push(j[t]);else s(k,e);l&&(m(l,h,e,f),m.uniqueSort(e));return e};m.uniqueSort=function(a){if(u){h=i,a.sort(u);if(h)for(var b=1;b0},m.find=function(a,b,c){var d,e,f,g,h,i;if(!a)return[];for(e=0,f=o.order.length;e":function(a,b){var c,d=typeof b=="string",e=0,f=a.length;if(d&&!l.test(b)){b=b.toLowerCase();for(;e=0)?c||d.push(h):c&&(b[g]=!1));return!1},ID:function(a){return a[1].replace(j,"")},TAG:function(a,b){return a[1].replace(j,"").toLowerCase()},CHILD:function(a){if(a[1]==="nth"){a[2]||m.error(a[0]),a[2]=a[2].replace(/^\+|\s*/g,"");var b=/(-?)(\d*)(?:n([+\-]?\d*))?/.exec(a[2]==="even"&&"2n"||a[2]==="odd"&&"2n+1"||!/\D/.test(a[2])&&"0n+"+a[2]||a[2]);a[2]=b[1]+(b[2]||1)-0,a[3]=b[3]-0}else a[2]&&m.error(a[0]);a[0]=e++;return a},ATTR:function(a,b,c,d,e,f){var g=a[1]=a[1].replace(j,"");!f&&o.attrMap[g]&&(a[1]=o.attrMap[g]),a[4]=(a[4]||a[5]||"").replace(j,""),a[2]==="~="&&(a[4]=" "+a[4]+" ");return a},PSEUDO:function(b,c,d,e,f){if(b[1]==="not")if((a.exec(b[3])||"").length>1||/^\w/.test(b[3]))b[3]=m(b[3],null,null,c);else{var g=m.filter(b[3],c,d,!0^f);d||e.push.apply(e,g);return!1}else if(o.match.POS.test(b[0])||o.match.CHILD.test(b[0]))return!0;return b},POS:function(a){a.unshift(!0);return a}},filters:{enabled:function(a){return a.disabled===!1&&a.type!=="hidden"},disabled:function(a){return a.disabled===!0},checked:function(a){return a.checked===!0},selected:function(a){a.parentNode&&a.parentNode.selectedIndex;return a.selected===!0},parent:function(a){return!!a.firstChild},empty:function(a){return!a.firstChild},has:function(a,b,c){return!!m(c[3],a).length},header:function(a){return/h\d/i.test(a.nodeName)},text:function(a){var b=a.getAttribute("type"),c=a.type;return a.nodeName.toLowerCase()==="input"&&"text"===c&&(b===c||b===null)},radio:function(a){return a.nodeName.toLowerCase()==="input"&&"radio"===a.type},checkbox:function(a){return a.nodeName.toLowerCase()==="input"&&"checkbox"===a.type},file:function(a){return a.nodeName.toLowerCase()==="input"&&"file"===a.type},password:function(a){return a.nodeName.toLowerCase()==="input"&&"password"===a.type},submit:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"submit"===a.type},image:function(a){return a.nodeName.toLowerCase()==="input"&&"image"===a.type},reset:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"reset"===a.type},button:function(a){var b=a.nodeName.toLowerCase();return b==="input"&&"button"===a.type||b==="button"},input:function(a){return/input|select|textarea|button/i.test(a.nodeName)},focus:function(a){return a===a.ownerDocument.activeElement}},setFilters:{first:function(a,b){return b===0},last:function(a,b,c,d){return b===d.length-1},even:function(a,b){return b%2===0},odd:function(a,b){return b%2===1},lt:function(a,b,c){return bc[3]-0},nth:function(a,b,c){return c[3]-0===b},eq:function(a,b,c){return c[3]-0===b}},filter:{PSEUDO:function(a,b,c,d){var e=b[1],f=o.filters[e];if(f)return f(a,c,b,d);if(e==="contains")return(a.textContent||a.innerText||n([a])||"").indexOf(b[3])>=0;if(e==="not"){var g=b[3];for(var h=0,i=g.length;h=0}},ID:function(a,b){return a.nodeType===1&&a.getAttribute("id")===b},TAG:function(a,b){return b==="*"&&a.nodeType===1||!!a.nodeName&&a.nodeName.toLowerCase()===b},CLASS:function(a,b){return(" "+(a.className||a.getAttribute("class"))+" ").indexOf(b)>-1},ATTR:function(a,b){var c=b[1],d=m.attr?m.attr(a,c):o.attrHandle[c]?o.attrHandle[c](a):a[c]!=null?a[c]:a.getAttribute(c),e=d+"",f=b[2],g=b[4];return d==null?f==="!=":!f&&m.attr?d!=null:f==="="?e===g:f==="*="?e.indexOf(g)>=0:f==="~="?(" "+e+" ").indexOf(g)>=0:g?f==="!="?e!==g:f==="^="?e.indexOf(g)===0:f==="$="?e.substr(e.length-g.length)===g:f==="|="?e===g||e.substr(0,g.length+1)===g+"-":!1:e&&d!==!1},POS:function(a,b,c,d){var e=b[2],f=o.setFilters[e];if(f)return f(a,c,b,d)}}},p=o.match.POS,q=function(a,b){return"\\"+(b-0+1)};for(var r in o.match)o.match[r]=new RegExp(o.match[r].source+/(?![^\[]*\])(?![^\(]*\))/.source),o.leftMatch[r]=new RegExp(/(^(?:.|\r|\n)*?)/.source+o.match[r].source.replace(/\\(\d+)/g,q));var s=function(a,b){a=Array.prototype.slice.call(a,0);if(b){b.push.apply(b,a);return b}return a};try{Array.prototype.slice.call(c.documentElement.childNodes,0)[0].nodeType}catch(t){s=function(a,b){var c=0,d=b||[];if(g.call(a)==="[object Array]")Array.prototype.push.apply(d,a);else if(typeof a.length=="number")for(var e=a.length;c",e.insertBefore(a,e.firstChild),c.getElementById(d)&&(o.find.ID=function(a,c,d){if(typeof c.getElementById!="undefined"&&!d){var e=c.getElementById(a[1]);return e?e.id===a[1]||typeof e.getAttributeNode!="undefined"&&e.getAttributeNode("id").nodeValue===a[1]?[e]:b:[]}},o.filter.ID=function(a,b){var c=typeof a.getAttributeNode!="undefined"&&a.getAttributeNode("id");return a.nodeType===1&&c&&c.nodeValue===b}),e.removeChild(a),e=a=null}(),function(){var a=c.createElement("div");a.appendChild(c.createComment("")),a.getElementsByTagName("*").length>0&&(o.find.TAG=function(a,b){var c=b.getElementsByTagName(a[1]);if(a[1]==="*"){var d=[];for(var e=0;c[e];e++)c[e].nodeType===1&&d.push(c[e]);c=d}return c}),a.innerHTML="",a.firstChild&&typeof a.firstChild.getAttribute!="undefined"&&a.firstChild.getAttribute("href")!=="#"&&(o.attrHandle.href=function(a){return a.getAttribute("href",2)}),a=null}(),c.querySelectorAll&&function(){var a=m,b=c.createElement("div"),d="__sizzle__";b.innerHTML="

";if(!b.querySelectorAll||b.querySelectorAll(".TEST").length!==0){m=function(b,e,f,g){e=e||c;if(!g&&!m.isXML(e)){var h=/^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec(b);if(h&&(e.nodeType===1||e.nodeType===9)){if(h[1])return s(e.getElementsByTagName(b),f);if(h[2]&&o.find.CLASS&&e.getElementsByClassName)return s(e.getElementsByClassName(h[2]),f)}if(e.nodeType===9){if(b==="body"&&e.body)return s([e.body],f);if(h&&h[3]){var i=e.getElementById(h[3]);if(!i||!i.parentNode)return s([],f);if(i.id===h[3])return s([i],f)}try{return s(e.querySelectorAll(b),f)}catch(j){}}else if(e.nodeType===1&&e.nodeName.toLowerCase()!=="object"){var k=e,l=e.getAttribute("id"),n=l||d,p=e.parentNode,q=/^\s*[+~]/.test(b);l?n=n.replace(/'/g,"\\$&"):e.setAttribute("id",n),q&&p&&(e=e.parentNode);try{if(!q||p)return s(e.querySelectorAll("[id='"+n+"'] "+b),f)}catch(r){}finally{l||k.removeAttribute("id")}}}return a(b,e,f,g)};for(var e in a)m[e]=a[e];b=null}}(),function(){var a=c.documentElement,b=a.matchesSelector||a.mozMatchesSelector||a.webkitMatchesSelector||a.msMatchesSelector;if(b){var d=!b.call(c.createElement("div"),"div"),e=!1;try{b.call(c.documentElement,"[test!='']:sizzle")}catch(f){e=!0}m.matchesSelector=function(a,c){c=c.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!m.isXML(a))try{if(e||!o.match.PSEUDO.test(c)&&!/!=/.test(c)){var f=b.call(a,c);if(f||!d||a.document&&a.document.nodeType!==11)return f}}catch(g){}return m(c,null,null,[a]).length>0}}}(),function(){var a=c.createElement("div");a.innerHTML="
";if(!!a.getElementsByClassName&&a.getElementsByClassName("e").length!==0){a.lastChild.className="e";if(a.getElementsByClassName("e").length===1)return;o.order.splice(1,0,"CLASS"),o.find.CLASS=function(a,b,c){if(typeof b.getElementsByClassName!="undefined"&&!c)return b.getElementsByClassName(a[1])},a=null}}(),c.documentElement.contains?m.contains=function(a,b){return a!==b&&(a.contains?a.contains(b):!0)}:c.documentElement.compareDocumentPosition?m.contains=function(a,b){return!!(a.compareDocumentPosition(b)&16)}:m.contains=function(){return!1},m.isXML=function(a){var b=(a?a.ownerDocument||a:0).documentElement;return b?b.nodeName!=="HTML":!1};var y=function(a,b,c){var d,e=[],f="",g=b.nodeType?[b]:b;while(d=o.match.PSEUDO.exec(a))f+=d[0],a=a.replace(o.match.PSEUDO,"");a=o.relative[a]?a+"*":a;for(var h=0,i=g.length;h0)for(h=g;h=0:f.filter(a,this).length>0:this.filter(a).length>0)},closest:function(a,b){var c=[],d,e,g=this[0];if(f.isArray(a)){var h=1;while(g&&g.ownerDocument&&g!==b){for(d=0;d-1:f.find.matchesSelector(g,a)){c.push(g);break}g=g.parentNode;if(!g||!g.ownerDocument||g===b||g.nodeType===11)break}}c=c.length>1?f.unique(c):c;return this.pushStack(c,"closest",a)},index:function(a){if(!a)return this[0]&&this[0].parentNode?this.prevAll().length:-1;if(typeof a=="string")return f.inArray(this[0],f(a));return f.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var c=typeof a=="string"?f(a,b):f.makeArray(a&&a.nodeType?[a]:a),d=f.merge(this.get(),c);return this.pushStack(S(c[0])||S(d[0])?d:f.unique(d))},andSelf:function(){return this.add(this.prevObject)}}),f.each({parent:function(a){var b=a.parentNode;return b&&b.nodeType!==11?b:null},parents:function(a){return f.dir(a,"parentNode")},parentsUntil:function(a,b,c){return f.dir(a,"parentNode",c)},next:function(a){return f.nth(a,2,"nextSibling")},prev:function(a){return f.nth(a,2,"previousSibling")},nextAll:function(a){return f.dir(a,"nextSibling")},prevAll:function(a){return f.dir(a,"previousSibling")},nextUntil:function(a,b,c){return f.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return f.dir(a,"previousSibling",c)},siblings:function(a){return f.sibling(a.parentNode.firstChild,a)},children:function(a){return f.sibling(a.firstChild)},contents:function(a){return f.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:f.makeArray(a.childNodes)}},function(a,b){f.fn[a]=function(c,d){var e=f.map(this,b,c);L.test(a)||(d=c),d&&typeof d=="string"&&(e=f.filter(d,e)),e=this.length>1&&!R[a]?f.unique(e):e,(this.length>1||N.test(d))&&M.test(a)&&(e=e.reverse());return this.pushStack(e,a,P.call(arguments).join(","))}}),f.extend({filter:function(a,b,c){c&&(a=":not("+a+")");return b.length===1?f.find.matchesSelector(b[0],a)?[b[0]]:[]:f.find.matches(a,b)},dir:function(a,c,d){var e=[],g=a[c];while(g&&g.nodeType!==9&&(d===b||g.nodeType!==1||!f(g).is(d)))g.nodeType===1&&e.push(g),g=g[c];return e},nth:function(a,b,c,d){b=b||1;var e=0;for(;a;a=a[c])if(a.nodeType===1&&++e===b)break;return a},sibling:function(a,b){var c=[];for(;a;a=a.nextSibling)a.nodeType===1&&a!==b&&c.push(a);return c}});var V="abbr|article|aside|audio|canvas|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",W=/ jQuery\d+="(?:\d+|null)"/g,X=/^\s+/,Y=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,Z=/<([\w:]+)/,$=/",""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]},bh=U(c);bg.optgroup=bg.option,bg.tbody=bg.tfoot=bg.colgroup=bg.caption=bg.thead,bg.th=bg.td,f.support.htmlSerialize||(bg._default=[1,"div
","
"]),f.fn.extend({text:function(a){if(f.isFunction(a))return this.each(function(b){var c=f(this);c.text(a.call(this,b,c.text()))});if(typeof a!="object"&&a!==b)return this.empty().append((this[0]&&this[0].ownerDocument||c).createTextNode(a));return f.text(this)},wrapAll:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapAll(a.call(this,b))});if(this[0]){var b=f(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&a.firstChild.nodeType===1)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapInner(a.call(this,b))});return this.each(function(){var b=f(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=f.isFunction(a);return this.each(function(c){f(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){f.nodeName(this,"body")||f(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.appendChild(a)})},prepend:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this)});if(arguments.length){var a=f.clean(arguments);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this.nextSibling)});if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,f.clean(arguments));return a}},remove:function(a,b){for(var c=0,d;(d=this[c])!=null;c++)if(!a||f.filter(a,[d]).length)!b&&d.nodeType===1&&(f.cleanData(d.getElementsByTagName("*")),f.cleanData([d])),d.parentNode&&d.parentNode.removeChild(d);return this},empty:function() +{for(var a=0,b;(b=this[a])!=null;a++){b.nodeType===1&&f.cleanData(b.getElementsByTagName("*"));while(b.firstChild)b.removeChild(b.firstChild)}return this},clone:function(a,b){a=a==null?!1:a,b=b==null?a:b;return this.map(function(){return f.clone(this,a,b)})},html:function(a){if(a===b)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(W,""):null;if(typeof a=="string"&&!ba.test(a)&&(f.support.leadingWhitespace||!X.test(a))&&!bg[(Z.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Y,"<$1>");try{for(var c=0,d=this.length;c1&&l0?this.clone(!0):this).get();f(e[h])[b](j),d=d.concat(j)}return this.pushStack(d,a,e.selector)}}),f.extend({clone:function(a,b,c){var d,e,g,h=f.support.html5Clone||!bc.test("<"+a.nodeName)?a.cloneNode(!0):bo(a);if((!f.support.noCloneEvent||!f.support.noCloneChecked)&&(a.nodeType===1||a.nodeType===11)&&!f.isXMLDoc(a)){bk(a,h),d=bl(a),e=bl(h);for(g=0;d[g];++g)e[g]&&bk(d[g],e[g])}if(b){bj(a,h);if(c){d=bl(a),e=bl(h);for(g=0;d[g];++g)bj(d[g],e[g])}}d=e=null;return h},clean:function(a,b,d,e){var g;b=b||c,typeof b.createElement=="undefined"&&(b=b.ownerDocument||b[0]&&b[0].ownerDocument||c);var h=[],i;for(var j=0,k;(k=a[j])!=null;j++){typeof k=="number"&&(k+="");if(!k)continue;if(typeof k=="string")if(!_.test(k))k=b.createTextNode(k);else{k=k.replace(Y,"<$1>");var l=(Z.exec(k)||["",""])[1].toLowerCase(),m=bg[l]||bg._default,n=m[0],o=b.createElement("div");b===c?bh.appendChild(o):U(b).appendChild(o),o.innerHTML=m[1]+k+m[2];while(n--)o=o.lastChild;if(!f.support.tbody){var p=$.test(k),q=l==="table"&&!p?o.firstChild&&o.firstChild.childNodes:m[1]===""&&!p?o.childNodes:[];for(i=q.length-1;i>=0;--i)f.nodeName(q[i],"tbody")&&!q[i].childNodes.length&&q[i].parentNode.removeChild(q[i])}!f.support.leadingWhitespace&&X.test(k)&&o.insertBefore(b.createTextNode(X.exec(k)[0]),o.firstChild),k=o.childNodes}var r;if(!f.support.appendChecked)if(k[0]&&typeof (r=k.length)=="number")for(i=0;i=0)return b+"px"}}}),f.support.opacity||(f.cssHooks.opacity={get:function(a,b){return br.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=f.isNumeric(b)?"alpha(opacity="+b*100+")":"",g=d&&d.filter||c.filter||"";c.zoom=1;if(b>=1&&f.trim(g.replace(bq,""))===""){c.removeAttribute("filter");if(d&&!d.filter)return}c.filter=bq.test(g)?g.replace(bq,e):g+" "+e}}),f(function(){f.support.reliableMarginRight||(f.cssHooks.marginRight={get:function(a,b){var c;f.swap(a,{display:"inline-block"},function(){b?c=bz(a,"margin-right","marginRight"):c=a.style.marginRight});return c}})}),c.defaultView&&c.defaultView.getComputedStyle&&(bA=function(a,b){var c,d,e;b=b.replace(bs,"-$1").toLowerCase(),(d=a.ownerDocument.defaultView)&&(e=d.getComputedStyle(a,null))&&(c=e.getPropertyValue(b),c===""&&!f.contains(a.ownerDocument.documentElement,a)&&(c=f.style(a,b)));return c}),c.documentElement.currentStyle&&(bB=function(a,b){var c,d,e,f=a.currentStyle&&a.currentStyle[b],g=a.style;f===null&&g&&(e=g[b])&&(f=e),!bt.test(f)&&bu.test(f)&&(c=g.left,d=a.runtimeStyle&&a.runtimeStyle.left,d&&(a.runtimeStyle.left=a.currentStyle.left),g.left=b==="fontSize"?"1em":f||0,f=g.pixelLeft+"px",g.left=c,d&&(a.runtimeStyle.left=d));return f===""?"auto":f}),bz=bA||bB,f.expr&&f.expr.filters&&(f.expr.filters.hidden=function(a){var b=a.offsetWidth,c=a.offsetHeight;return b===0&&c===0||!f.support.reliableHiddenOffsets&&(a.style&&a.style.display||f.css(a,"display"))==="none"},f.expr.filters.visible=function(a){return!f.expr.filters.hidden(a)});var bD=/%20/g,bE=/\[\]$/,bF=/\r?\n/g,bG=/#.*$/,bH=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,bI=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,bJ=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,bK=/^(?:GET|HEAD)$/,bL=/^\/\//,bM=/\?/,bN=/)<[^<]*)*<\/script>/gi,bO=/^(?:select|textarea)/i,bP=/\s+/,bQ=/([?&])_=[^&]*/,bR=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+))?)?/,bS=f.fn.load,bT={},bU={},bV,bW,bX=["*/"]+["*"];try{bV=e.href}catch(bY){bV=c.createElement("a"),bV.href="",bV=bV.href}bW=bR.exec(bV.toLowerCase())||[],f.fn.extend({load:function(a,c,d){if(typeof a!="string"&&bS)return bS.apply(this,arguments);if(!this.length)return this;var e=a.indexOf(" ");if(e>=0){var g=a.slice(e,a.length);a=a.slice(0,e)}var h="GET";c&&(f.isFunction(c)?(d=c,c=b):typeof c=="object"&&(c=f.param(c,f.ajaxSettings.traditional),h="POST"));var i=this;f.ajax({url:a,type:h,dataType:"html",data:c,complete:function(a,b,c){c=a.responseText,a.isResolved()&&(a.done(function(a){c=a}),i.html(g?f("
").append(c.replace(bN,"")).find(g):c)),d&&i.each(d,[c,b,a])}});return this},serialize:function(){return f.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?f.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||bO.test(this.nodeName)||bI.test(this.type))}).map(function(a,b){var c=f(this).val();return c==null?null:f.isArray(c)?f.map(c,function(a,c){return{name:b.name,value:a.replace(bF,"\r\n")}}):{name:b.name,value:c.replace(bF,"\r\n")}}).get()}}),f.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(a,b){f.fn[b]=function(a){return this.on(b,a)}}),f.each(["get","post"],function(a,c){f[c]=function(a,d,e,g){f.isFunction(d)&&(g=g||e,e=d,d=b);return f.ajax({type:c,url:a,data:d,success:e,dataType:g})}}),f.extend({getScript:function(a,c){return f.get(a,b,c,"script")},getJSON:function(a,b,c){return f.get(a,b,c,"json")},ajaxSetup:function(a,b){b?b_(a,f.ajaxSettings):(b=a,a=f.ajaxSettings),b_(a,b);return a},ajaxSettings:{url:bV,isLocal:bJ.test(bW[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":bX},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":a.String,"text html":!0,"text json":f.parseJSON,"text xml":f.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:bZ(bT),ajaxTransport:bZ(bU),ajax:function(a,c){function w(a,c,l,m){if(s!==2){s=2,q&&clearTimeout(q),p=b,n=m||"",v.readyState=a>0?4:0;var o,r,u,w=c,x=l?cb(d,v,l):b,y,z;if(a>=200&&a<300||a===304){if(d.ifModified){if(y=v.getResponseHeader("Last-Modified"))f.lastModified[k]=y;if(z=v.getResponseHeader("Etag"))f.etag[k]=z}if(a===304)w="notmodified",o=!0;else try{r=cc(d,x),w="success",o=!0}catch(A){w="parsererror",u=A}}else{u=w;if(!w||a)w="error",a<0&&(a=0)}v.status=a,v.statusText=""+(c||w),o?h.resolveWith(e,[r,w,v]):h.rejectWith(e,[v,w,u]),v.statusCode(j),j=b,t&&g.trigger("ajax"+(o?"Success":"Error"),[v,d,o?r:u]),i.fireWith(e,[v,w]),t&&(g.trigger("ajaxComplete",[v,d]),--f.active||f.event.trigger("ajaxStop"))}}typeof a=="object"&&(c=a,a=b),c=c||{};var d=f.ajaxSetup({},c),e=d.context||d,g=e!==d&&(e.nodeType||e instanceof f)?f(e):f.event,h=f.Deferred(),i=f.Callbacks("once memory"),j=d.statusCode||{},k,l={},m={},n,o,p,q,r,s=0,t,u,v={readyState:0,setRequestHeader:function(a,b){if(!s){var c=a.toLowerCase();a=m[c]=m[c]||a,l[a]=b}return this},getAllResponseHeaders:function(){return s===2?n:null},getResponseHeader:function(a){var c;if(s===2){if(!o){o={};while(c=bH.exec(n))o[c[1].toLowerCase()]=c[2]}c=o[a.toLowerCase()]}return c===b?null:c},overrideMimeType:function(a){s||(d.mimeType=a);return this},abort:function(a){a=a||"abort",p&&p.abort(a),w(0,a);return this}};h.promise(v),v.success=v.done,v.error=v.fail,v.complete=i.add,v.statusCode=function(a){if(a){var b;if(s<2)for(b in a)j[b]=[j[b],a[b]];else b=a[v.status],v.then(b,b)}return this},d.url=((a||d.url)+"").replace(bG,"").replace(bL,bW[1]+"//"),d.dataTypes=f.trim(d.dataType||"*").toLowerCase().split(bP),d.crossDomain==null&&(r=bR.exec(d.url.toLowerCase()),d.crossDomain=!(!r||r[1]==bW[1]&&r[2]==bW[2]&&(r[3]||(r[1]==="http:"?80:443))==(bW[3]||(bW[1]==="http:"?80:443)))),d.data&&d.processData&&typeof d.data!="string"&&(d.data=f.param(d.data,d.traditional)),b$(bT,d,c,v);if(s===2)return!1;t=d.global,d.type=d.type.toUpperCase(),d.hasContent=!bK.test(d.type),t&&f.active++===0&&f.event.trigger("ajaxStart");if(!d.hasContent){d.data&&(d.url+=(bM.test(d.url)?"&":"?")+d.data,delete d.data),k=d.url;if(d.cache===!1){var x=f.now(),y=d.url.replace(bQ,"$1_="+x);d.url=y+(y===d.url?(bM.test(d.url)?"&":"?")+"_="+x:"")}}(d.data&&d.hasContent&&d.contentType!==!1||c.contentType)&&v.setRequestHeader("Content-Type",d.contentType),d.ifModified&&(k=k||d.url,f.lastModified[k]&&v.setRequestHeader("If-Modified-Since",f.lastModified[k]),f.etag[k]&&v.setRequestHeader("If-None-Match",f.etag[k])),v.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+(d.dataTypes[0]!=="*"?", "+bX+"; q=0.01":""):d.accepts["*"]);for(u in d.headers)v.setRequestHeader(u,d.headers[u]);if(d.beforeSend&&(d.beforeSend.call(e,v,d)===!1||s===2)){v.abort();return!1}for(u in{success:1,error:1,complete:1})v[u](d[u]);p=b$(bU,d,c,v);if(!p)w(-1,"No Transport");else{v.readyState=1,t&&g.trigger("ajaxSend",[v,d]),d.async&&d.timeout>0&&(q=setTimeout(function(){v.abort("timeout")},d.timeout));try{s=1,p.send(l,w)}catch(z){if(s<2)w(-1,z);else throw z}}return v},param:function(a,c){var d=[],e=function(a,b){b=f.isFunction(b)?b():b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};c===b&&(c=f.ajaxSettings.traditional);if(f.isArray(a)||a.jquery&&!f.isPlainObject(a))f.each(a,function(){e(this.name,this.value)});else for(var g in a)ca(g,a[g],c,e);return d.join("&").replace(bD,"+")}}),f.extend({active:0,lastModified:{},etag:{}});var cd=f.now(),ce=/(\=)\?(&|$)|\?\?/i;f.ajaxSetup({jsonp:"callback",jsonpCallback:function(){return f.expando+"_"+cd++}}),f.ajaxPrefilter("json jsonp",function(b,c,d){var e=b.contentType==="application/x-www-form-urlencoded"&&typeof b.data=="string";if(b.dataTypes[0]==="jsonp"||b.jsonp!==!1&&(ce.test(b.url)||e&&ce.test(b.data))){var g,h=b.jsonpCallback=f.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,i=a[h],j=b.url,k=b.data,l="$1"+h+"$2";b.jsonp!==!1&&(j=j.replace(ce,l),b.url===j&&(e&&(k=k.replace(ce,l)),b.data===k&&(j+=(/\?/.test(j)?"&":"?")+b.jsonp+"="+h))),b.url=j,b.data=k,a[h]=function(a){g=[a]},d.always(function(){a[h]=i,g&&f.isFunction(i)&&a[h](g[0])}),b.converters["script json"]=function(){g||f.error(h+" was not called");return g[0]},b.dataTypes[0]="json";return"script"}}),f.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(a){f.globalEval(a);return a}}}),f.ajaxPrefilter("script",function(a){a.cache===b&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),f.ajaxTransport("script",function(a){if(a.crossDomain){var d,e=c.head||c.getElementsByTagName("head")[0]||c.documentElement;return{send:function(f,g){d=c.createElement("script"),d.async="async",a.scriptCharset&&(d.charset=a.scriptCharset),d.src=a.url,d.onload=d.onreadystatechange=function(a,c){if(c||!d.readyState||/loaded|complete/.test(d.readyState))d.onload=d.onreadystatechange=null,e&&d.parentNode&&e.removeChild(d),d=b,c||g(200,"success")},e.insertBefore(d,e.firstChild)},abort:function(){d&&d.onload(0,1)}}}});var cf=a.ActiveXObject?function(){for(var a in ch)ch[a](0,1)}:!1,cg=0,ch;f.ajaxSettings.xhr=a.ActiveXObject?function(){return!this.isLocal&&ci()||cj()}:ci,function(a){f.extend(f.support,{ajax:!!a,cors:!!a&&"withCredentials"in a})}(f.ajaxSettings.xhr()),f.support.ajax&&f.ajaxTransport(function(c){if(!c.crossDomain||f.support.cors){var d;return{send:function(e,g){var h=c.xhr(),i,j;c.username?h.open(c.type,c.url,c.async,c.username,c.password):h.open(c.type,c.url,c.async);if(c.xhrFields)for(j in c.xhrFields)h[j]=c.xhrFields[j];c.mimeType&&h.overrideMimeType&&h.overrideMimeType(c.mimeType),!c.crossDomain&&!e["X-Requested-With"]&&(e["X-Requested-With"]="XMLHttpRequest");try{for(j in e)h.setRequestHeader(j,e[j])}catch(k){}h.send(c.hasContent&&c.data||null),d=function(a,e){var j,k,l,m,n;try{if(d&&(e||h.readyState===4)){d=b,i&&(h.onreadystatechange=f.noop,cf&&delete ch[i]);if(e)h.readyState!==4&&h.abort();else{j=h.status,l=h.getAllResponseHeaders(),m={},n=h.responseXML,n&&n.documentElement&&(m.xml=n),m.text=h.responseText;try{k=h.statusText}catch(o){k=""}!j&&c.isLocal&&!c.crossDomain?j=m.text?200:404:j===1223&&(j=204)}}}catch(p){e||g(-1,p)}m&&g(j,k,m,l)},!c.async||h.readyState===4?d():(i=++cg,cf&&(ch||(ch={},f(a).unload(cf)),ch[i]=d),h.onreadystatechange=d)},abort:function(){d&&d(0,1)}}}});var ck={},cl,cm,cn=/^(?:toggle|show|hide)$/,co=/^([+\-]=)?([\d+.\-]+)([a-z%]*)$/i,cp,cq=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]],cr;f.fn.extend({show:function(a,b,c){var d,e;if(a||a===0)return this.animate(cu("show",3),a,b,c);for(var g=0,h=this.length;g=i.duration+this.startTime){this.now=this.end,this.pos=this.state=1,this.update(),i.animatedProperties[this.prop]=!0;for(b in i.animatedProperties)i.animatedProperties[b]!==!0&&(g=!1);if(g){i.overflow!=null&&!f.support.shrinkWrapBlocks&&f.each(["","X","Y"],function(a,b){h.style["overflow"+b]=i.overflow[a]}),i.hide&&f(h).hide();if(i.hide||i.show)for(b in i.animatedProperties)f.style(h,b,i.orig[b]),f.removeData(h,"fxshow"+b,!0),f.removeData(h,"toggle"+b,!0);d=i.complete,d&&(i.complete=!1,d.call(h))}return!1}i.duration==Infinity?this.now=e:(c=e-this.startTime,this.state=c/i.duration,this.pos=f.easing[i.animatedProperties[this.prop]](this.state,c,0,1,i.duration),this.now=this.start+(this.end-this.start)*this.pos),this.update();return!0}},f.extend(f.fx,{tick:function(){var a,b=f.timers,c=0;for(;c-1,k={},l={},m,n;j?(l=e.position(),m=l.top,n=l.left):(m=parseFloat(h)||0,n=parseFloat(i)||0),f.isFunction(b)&&(b=b.call(a,c,g)),b.top!=null&&(k.top=b.top-g.top+m),b.left!=null&&(k.left=b.left-g.left+n),"using"in b?b.using.call(a,k):e.css(k)}},f.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),c=this.offset(),d=cx.test(b[0].nodeName)?{top:0,left:0}:b.offset();c.top-=parseFloat(f.css(a,"marginTop"))||0,c.left-=parseFloat(f.css(a,"marginLeft"))||0,d.top+=parseFloat(f.css(b[0],"borderTopWidth"))||0,d.left+=parseFloat(f.css(b[0],"borderLeftWidth"))||0;return{top:c.top-d.top,left:c.left-d.left}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||c.body;while(a&&!cx.test(a.nodeName)&&f.css(a,"position")==="static")a=a.offsetParent;return a})}}),f.each(["Left","Top"],function(a,c){var d="scroll"+c;f.fn[d]=function(c){var e,g;if(c===b){e=this[0];if(!e)return null;g=cy(e);return g?"pageXOffset"in g?g[a?"pageYOffset":"pageXOffset"]:f.support.boxModel&&g.document.documentElement[d]||g.document.body[d]:e[d]}return this.each(function(){g=cy(this),g?g.scrollTo(a?f(g).scrollLeft():c,a?c:f(g).scrollTop()):this[d]=c})}}),f.each(["Height","Width"],function(a,c){var d=c.toLowerCase();f.fn["inner"+c]=function(){var a=this[0];return a?a.style?parseFloat(f.css(a,d,"padding")):this[d]():null},f.fn["outer"+c]=function(a){var b=this[0];return b?b.style?parseFloat(f.css(b,d,a?"margin":"border")):this[d]():null},f.fn[d]=function(a){var e=this[0];if(!e)return a==null?null:this;if(f.isFunction(a))return this.each(function(b){var c=f(this);c[d](a.call(this,b,c[d]()))});if(f.isWindow(e)){var g=e.document.documentElement["client"+c],h=e.document.body;return e.document.compatMode==="CSS1Compat"&&g||h&&h["client"+c]||g}if(e.nodeType===9)return Math.max(e.documentElement["client"+c],e.body["scroll"+c],e.documentElement["scroll"+c],e.body["offset"+c],e.documentElement["offset"+c]);if(a===b){var i=f.css(e,d),j=parseFloat(i);return f.isNumeric(j)?j:i}return this.css(d,typeof a=="string"?a:a+"px")}}),a.jQuery=a.$=f,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return f})})(window); \ No newline at end of file diff --git a/lib/core_ext/string.rb b/lib/core_ext/string.rb deleted file mode 100644 index 1f00ded..0000000 --- a/lib/core_ext/string.rb +++ /dev/null @@ -1,28 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -# Extensions to class String. -# @author Thorsten Kummerow (@thomerow) -class String - - # Removes the first and last characters from a string and returns the - # manipulated string. - # @return [String] The string without its first and last characters. - def remove_first_and_last - if self.length == 0 then return '' end - result = self.dup - result[0] = '' - if result.length > 0 then result[result.length - 1] = '' end - return result - end -end diff --git a/lib/txtextcontrol/reportingcloud.rb b/lib/txtextcontrol/reportingcloud.rb deleted file mode 100644 index 1fb0652..0000000 --- a/lib/txtextcontrol/reportingcloud.rb +++ /dev/null @@ -1,31 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require "txtextcontrol/reportingcloud/version" -require_relative "./reportingcloud/reportingcloud.rb" - -# The TXTextControl module. -module TXTextControl - - # The ReportingCloud module. - module ReportingCloud - - # Default API base url. - DEFAULT_BASE_URI = "https://api.reporting.cloud" - # Default API version. - DEFAULT_VERSION = "v1" - # Default http request timeout in seconds. - DEFAULT_TIMEOUT = 10 - - end -end diff --git a/lib/txtextcontrol/reportingcloud/account_settings.rb b/lib/txtextcontrol/reportingcloud/account_settings.rb deleted file mode 100644 index 71b44d4..0000000 --- a/lib/txtextcontrol/reportingcloud/account_settings.rb +++ /dev/null @@ -1,88 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -module TXTextControl - module ReportingCloud - - # Represents ReportingCloud account settings. - # @attr_reader [String, Symbol] serial_number The serial number that is attached to the - # account. Possible values are +:free+, +:trial+ and a 13 character long serial number. - # @attr_reader [Integer] created_documents The number of created documents in the - # current month. - # @attr_reader [Integer] uploaded_templates The number of uploaded templates to the - # template storage. - # @attr_reader [Integer] max_documents The maximum number of documents that can be - # created per month. - # @attr_reader [Integer] max_templates The maximum number of templates that can be - # uploaded to the template storage. - # @attr_reader [DateTime] valid_until The date until the current subscription is valid. - # Can be nil. - # @author Thorsten Kummerow (@thomerow) - class AccountSettings - attr_reader :serial_number - attr_reader :created_documents - attr_reader :uploaded_templates - attr_reader :max_documents - attr_reader :max_templates - attr_reader :valid_until - - # @param [String, Symbol] serial_number The serial number that is attached to the - # account. Possible values are +:free+, +:trial+ and a 13 character long serial number. - # @param [Integer] created_documents The number of created documents in the - # current month. - # @param [Integer] uploaded_templates The number of uploaded templates to the - # template storage. - # @param [Integer] max_documents The maximum number of documents that can be - # created per month. - # @param [Integer] max_templates The maximum number of templates that can be - # uploaded to the template storage. - # @param [DateTime] valid_until The date until the current subscription is valid. - # Can be nil. - def initialize(serial_number, created_documents, uploaded_templates, max_documents, max_templates, valid_until = nil) - case serial_number.downcase - when "trial" - @serial_number = :trial - when "free" - @serial_number = :free - else - @serial_number = serial_number - end - @created_documents = Integer(created_documents) - @uploaded_templates = Integer(uploaded_templates) - @max_documents = Integer(max_documents) - @max_templates = Integer(max_templates) - case valid_until - when DateTime - @valid_until = valid_until - when String - @valid_until = DateTime.iso8601(valid_until) - else - @valid_until = nil - end - end - - # Creates an AccountSettings instance from a hash. - # @param [Hash] hash The hash to try and create an AccountSettings instance from. - # @return [AccountSettings] A newly created AccountSettings instance. - def self.from_camelized_hash(hash) - sn = hash["serialNumber"] - cd = hash["createdDocuments"] - ut = hash["uploadedTemplates"] - md = hash["maxDocuments"] - mt = hash["maxTemplates"] - vu = hash["validUntil"] - return AccountSettings.new(sn, cd, ut, md, mt, vu) - end - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/api_key.rb b/lib/txtextcontrol/reportingcloud/api_key.rb deleted file mode 100644 index 241403d..0000000 --- a/lib/txtextcontrol/reportingcloud/api_key.rb +++ /dev/null @@ -1,44 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -module TXTextControl - module ReportingCloud - - # Represents a ReportingCloud API key object. - # @attr key [String] The actual API Key that belongs to the account. - # @attr is_active [Boolean] Specifies whether the API Key is active or not (not used yet). - # @author Thorsten Kummerow (@thomerow) - class APIKey - attr_reader :is_active - - # @param key [String] The actual API Key that belongs to the account. - # @param is_active [Boolean] Specifies whether the API Key is active or not (not used yet). - def initialize(key, is_active = true) - self.key = key - @is_active = is_active - end - - def key - @key - end - - def key=(val) - unless val.nil? || ((val.kind_of? String) && !val.to_s.empty?) - raise ArgumentError, "API key must be a non empty string." - end - @key = val - end - - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/append_body.rb b/lib/txtextcontrol/reportingcloud/append_body.rb deleted file mode 100644 index b4724f6..0000000 --- a/lib/txtextcontrol/reportingcloud/append_body.rb +++ /dev/null @@ -1,70 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require "txtextcontrol/reportingcloud/append_document" -require "txtextcontrol/reportingcloud/document_settings" - -module TXTextControl - module ReportingCloud - - # Passes data to the {ReportingCloud.append_documents} method. - # @attr documents [Array] The documents that are appended. - # @attr document_settings [DocumentSettings] Optional. Document settings to specify - # document properties such as title and author. - # @author Thorsten Kummerow (@thomerow) - class AppendBody - - def initialize(documents, document_settings = nil) - self.documents = documents - self.document_settings = document_settings - end - - def documents - @documents - end - - def documents=(val) - unless val.kind_of?(Array) - raise ArgumentError, "Not an qarray." - end - val.each do |elem| - unless elem.is_a?(TXTextControl::ReportingCloud::AppendDocument) - raise ArgumentError, "Only elements of type \"AppendDocument\" are allowed." - end - end - @documents = val - end - - def document_settings - @document_settings - end - - def document_settings=(val) - unless val.is_a?(TXTextControl::ReportingCloud::DocumentSettings) - raise ArgumentError, "Must be a DocumentSettings instance." - end - @document_settings = val; - end - - # Converts an AppendBody instance to a hash while converting the attribute names - # from snake case to camel case. - # @return [Hash] A hash representing the AppendBody instance. - def to_camelized_hash - return { - "documents" => @documents.map { |d| d.to_camelized_hash }, - "documentSettings" => @document_settings.nil? ? nil : @document_settings.to_camelized_hash - } - end - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/append_document.rb b/lib/txtextcontrol/reportingcloud/append_document.rb deleted file mode 100644 index 07208b7..0000000 --- a/lib/txtextcontrol/reportingcloud/append_document.rb +++ /dev/null @@ -1,61 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -module TXTextControl - module ReportingCloud - - # Passes data to the {ReportingCloud.append_documents} method. - # @attr document [String] The document as a Base64 encoded string. - # @attr document_divider [Symbol] The document divider option. Possible values are - # +:none+, +:new_paragraph+ and +:new_section+. - # @author Thorsten Kummerow (@thomerow) - class AppendDocument - attr_accessor :document_divider - - def initialize(document, document_divider = :none) - self.document = document - @document_divider = document_divider - end - - def document - @document - end - - def document=(val) - unless val.is_a?(String) - raise ArgumentError, "document must be a Base64 encoded string." - end - @document = val - end - - # Converts an AppendBody instance to a hash while converting the attribute names - # from snake case to camel case. - # @return [Hash] A hash representing the AppendBody instance. - def to_camelized_hash - result = { - "document" => @document, - "documentDivider" => "None" - } - - case @document_divider - when :new_paragraph - result["documentDivider"] = "NewParagraph" - when :new_section - result["documentDivider"] = "NewSection" - end - - return result - end - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/document_settings.rb b/lib/txtextcontrol/reportingcloud/document_settings.rb deleted file mode 100644 index cda16f7..0000000 --- a/lib/txtextcontrol/reportingcloud/document_settings.rb +++ /dev/null @@ -1,93 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -module TXTextControl - module ReportingCloud - - # Holds the merge settings needed by the {ReportingCloud.append_documents} - # method. - # @attr author [String] The document's author. - # @attr creation_date [DateTime] The document's creation date. - # @attr creator_application [String] The application which created the document. - # @attr document_subject [String] The document's subject. - # @attr document_title [String] The document's title. - # @attr last_modification_date [DateTime] The document's last modification date. - # @attr user_password [String] The password needed to open the document. - # @author Thorsten Kummerow (@thomerow) - class DocumentSettings - attr_accessor :author - attr_accessor :creator_application - attr_accessor :document_subject - attr_accessor :document_title - attr_accessor :user_password - - def initialize - @author = nil - @creation_date = nil - @creator_application = nil - @document_subject = nil - @document_title = nil - @last_modification_date = nil - @user_password = nil - end - - def creation_date - @creation_date - end - - def creation_date=(val) - case val - when nil - @creation_date = nil - when String - @creation_date = DateTime.iso8601(val) - when DateTime - @creation_date = val - else raise ArgumentError, "Value must be a string or an instance of type DateTime." - end - end - - def last_modification_date - @last_modification_date - end - - def last_modification_date=(val) - case val - when nil - @last_modification_date = nil - when String - @last_modification_date = DateTime.iso8601(val) - when DateTime - @last_modification_date = val - else raise ArgumentError, "Value must be a string or an instance of type DateTime." - end - end - - # Converts a DocumentSettings instance to a hash while converting the attribute names - # from snake case to camel case. - # @return [Hash] A hash representing the DocumentSettings instance. - def to_camelized_hash - return { - "author" => @author, - "creationDate" => @creation_date.nil? ? nil : @creation_date.iso8601, - "creatorApplication" => @creator_application, - "documentSubject" => @document_subject, - "documentTitle" => @document_title, - "lastModificationDate" => @last_modification_date.nil? ? nil : @last_modification_date.iso8601, - "userPassword" => @user_password - } - end - - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/find_and_replace_body.rb b/lib/txtextcontrol/reportingcloud/find_and_replace_body.rb deleted file mode 100644 index a6471df..0000000 --- a/lib/txtextcontrol/reportingcloud/find_and_replace_body.rb +++ /dev/null @@ -1,91 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require "txtextcontrol/reportingcloud/merge_settings" - -module TXTextControl - module ReportingCloud - - # The request body of requests to the endpoint "/document/findandreplace". Contains - # an array of string arrays, a template encoded as a Base64 string and a ReportingCloud - # MergeSettings object. - # @attr find_and_replace_data [Array>] The find and replace - # pair values as an array of string arrays. - # @attr merge_settings [MergeSettings] Merge settings to specify merge - # properties and document properties such as title and author. - # @attr template [String] The source document encoded as a Base64 string. - class FindAndReplaceBody - attr_accessor :find_and_replace_data - attr_accessor :merge_settings - attr_accessor :template - - # @param find_and_replace_data [Array>] The find and replace - # pair values as an array of string arrays. - # @param template [String] The source document encoded as a Base64 string. - # The supported document formats are +.rtf+, +.doc+, +.docx+, and +.tx+. - # @param merge_settings [MergeSettings] Merge settings to specify merge - # properties and document properties such as title and author. - def initialize(find_and_replace_data, template = nil, merge_settings = nil) - self.find_and_replace_data = find_and_replace_data - self.template = template - self.merge_settings = merge_settings - end - - def find_and_replace_data - @find_and_replace_data - end - - def find_and_replace_data=(val) - unless !val.nil? && (val.kind_of? Array) && !val.empty? && (val.all? { |elem| elem.kind_of? Array }) && - (val.all? { |elem| (elem.length == 2) && (elem[0].kind_of? String) && (elem[1].kind_of? String) }) - raise ArgumentError, "Find and replace data must be a non empty array of string arrays containing two strings each." - end - @find_and_replace_data = val - end - - def merge_settings - @merge_settings - end - - def merge_settings=(val) - unless val.nil? || (val.kind_of? MergeSettings) - raise ArgumentError, "Merge settings must be of type MergeSettings." - end - @merge_settings = val - end - - def template - @template - end - - def template=(val) - unless val.nil? || ((val.kind_of? String) && !val.to_s.empty?) - raise ArgumentError, "Template data must be a non empty string." - end - @template = val - end - - # Converts a FindAndReplaceBody instance to a hash while converting the attribute names - # from snake case to camel case. - # @return [Hash] A hash representing the FindAndReplaceBody instance. - def to_camelized_hash - return { - "findAndReplaceData" => @find_and_replace_data, - "template" => @template, - "mergeSettings" => @merge_settings - } - end - end - end -end - diff --git a/lib/txtextcontrol/reportingcloud/incorrect_word.rb b/lib/txtextcontrol/reportingcloud/incorrect_word.rb deleted file mode 100644 index c00a21b..0000000 --- a/lib/txtextcontrol/reportingcloud/incorrect_word.rb +++ /dev/null @@ -1,63 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -module TXTextControl - module ReportingCloud - - # Represents an incorrect word in spell checked text. - # @attr_reader [Integer] length The length of the spelled word. - # @attr_reader [Integer] start The starting position of a spelled word. - # @attr_reader [String] text The text of the spelled word. - # @attr_reader [Boolean] is_duplicate Indicating whether the spelled word is - # declared as incorrect, because the previous word has the same text. - # @attr_reader [String] language Indicating the language the incorrect word - # was spelled. - # @author Thorsten Kummerow (@thomerow) - class IncorrectWord - attr_reader :length - attr_reader :start - attr_reader :text - attr_reader :is_duplicate - attr_reader :language - - alias_method :is_duplicate?, :is_duplicate - - # @param [Integer] length The starting position of a spelled word. - # @param [Integer] start The starting position of a spelled word. - # @param [String] text The text of the spelled word. - # @param [Boolean] is_duplicate Indicating whether the spelled word is - # declared as incorrect, because the previous word has the same text. - # @param [String] language Indicating the language the incorrect word - # was spelled. - def initialize(length, start, text, is_duplicate, language) - @length = Integer(length) - @start = Integer(start) - @text = text - @is_duplicate = !!is_duplicate - @language = language - end - - # Creates an IncorrectWord instance from a hash. - # @param [Hash] hash The hash to try and create an IncorrectWord instance from. - # @return [IncorrectWord] A newly created IncorrectWord instance. - def self.from_camelized_hash(hash) - l = hash["length"] - s = hash["start"] - txt = hash["text"] - id = hash["isDuplicate"] - lan = hash["language"] - return IncorrectWord.new(l, s, txt, id, lan) - end - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/merge_block.rb b/lib/txtextcontrol/reportingcloud/merge_block.rb deleted file mode 100644 index 701f4c0..0000000 --- a/lib/txtextcontrol/reportingcloud/merge_block.rb +++ /dev/null @@ -1,61 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require 'txtextcontrol/reportingcloud/merge_field' - -module TXTextControl - module ReportingCloud - - # Represents a merge block in a document template. - # @attr_reader [String] name The merge block's' name. - # @attr_reader [Array] merge_blocks The merge blocks nested - # inside the merge block. - # @attr_reader [Array] merge_fields The merge fields inside - # the merge block. - class MergeBlock - attr_reader :name - attr_reader :merge_blocks - attr_reader :merge_fields - - def initialize(name, merge_blocks, merge_fields) - # Parameter validation - raise ArgumentError, "Block name must be a string." if !name.kind_of? String - raise ArgumentError, "Parameter merge_blocks must be an array." if !merge_blocks.kind_of? Array - raise ArgumentError, "Parameter merge_fields must be an array." if !merge_fields.kind_of? Array - - @name = name - @merge_blocks = merge_blocks - @merge_fields = merge_fields - end - - # Creates an MergeBlock instance from a hash. - # @param [Hash] hash The hash to try and create an MergeBlock instance from. - # @return [MergeBlock] A newly created MergeBlock instance. - def self.from_camelized_hash(hash) - # Parameter validation - raise ArgumentError, "Parameter must be a Hash." if !hash.kind_of? Hash - - name = hash["name"] - blocks = Array.new - hash["mergeBlocks"].each do |elem| - blocks.push(MergeBlock.from_camelized_hash(elem)) - end - fields = Array.new - hash["mergeFields"].each do |elem| - fields.push(MergeField.from_camelized_hash(elem)) - end - return MergeBlock.new(name, blocks, fields) - end - end - end -end \ No newline at end of file diff --git a/lib/txtextcontrol/reportingcloud/merge_body.rb b/lib/txtextcontrol/reportingcloud/merge_body.rb deleted file mode 100644 index fd2dc99..0000000 --- a/lib/txtextcontrol/reportingcloud/merge_body.rb +++ /dev/null @@ -1,67 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require "txtextcontrol/reportingcloud/merge_settings" - -module TXTextControl - module ReportingCloud - - # Passes data to the {ReportingCloud.merge_document} method. - # @attr merge_data [Array] The merge data. Must be an array of hashes. - # @attr template [String] Base64 encoded template document. - # Supported formats are RTF, DOC, DOCX and TX. - # @attr merge_settings [MergeSettings] Merge settings to specify - # merge properties and document properties such as title and - # author. - # @author Thorsten Kummerow (@thomerow) - class MergeBody - attr_accessor :template - attr_accessor :merge_settings - - # The constructor. - # @param merge_data [Array] The merge data. Must be an array of hashes. - # @param template [String] Base64 encoded template document. - # Supported formats are RTF, DOC, DOCX and TX. - # @param merge_settings [MergeSettings] Merge settings to specify - # merge properties and document properties such as title and - # author. - def initialize(merge_data, merge_settings = nil, template = nil) - self.merge_data = merge_data - @template = template - @merge_settings = merge_settings - end - - def merge_data=(val) - unless val.kind_of?(Array) && !val.empty? && val[0].kind_of?(Hash) - raise ArgumentError, "Merge data must be a non empty array of hashes." - end - @merge_data = val - end - - def merge_data - @merge_data - end - - # Converts a MergeBody instance to a hash while converting the attribute names - # from snake case to camel case. - # @return [Hash] A hash representing the MergeBody instance. - def to_camelized_hash - return { - "mergeData" => @merge_data, - "template" => @template, - "mergeSettings" => @merge_settings.nil? ? nil : @merge_settings.to_camelized_hash - } - end - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/merge_field.rb b/lib/txtextcontrol/reportingcloud/merge_field.rb deleted file mode 100644 index 57d8e7a..0000000 --- a/lib/txtextcontrol/reportingcloud/merge_field.rb +++ /dev/null @@ -1,78 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -module TXTextControl - module ReportingCloud - - # Represents a merge field in a document template. - # @attr_reader [String] date_time_format The format which is applied to - # date / time values. - # @attr_reader [String] name The name of the field. - # @attr_reader [String] numeric_format The format which is applied to - # numeric values. - # @attr_reader [Boolean] preserve_formatting Specifies whether formatting is - # preserved. - # @attr_reader [String] text The field text. - # @attr_reader [String] text_after The text after the field. - # @attr_reader [String] text_before The text before the field. - class MergeField - attr_reader :date_time_format - attr_reader :name - attr_reader :numeric_format - attr_reader :preserve_formatting - attr_reader :text - attr_reader :text_after - attr_reader :text_before - - def initialize(date_time_format, name, numeric_format, preserve_formatting, text, text_after, text_before) - # Parameter validation - unless date_time_format.nil? || (date_time_format.kind_of? String) - raise ArgumentError, "Date / time format must be a string." - end - raise ArgumentError, "Field name must be a string." if !name.kind_of? String - unless numeric_format.nil? || (numeric_format.kind_of? String) - raise ArgumentError, "Numeric format must be a string" - end - raise ArgumentError, "Preserve formatting parameter must be a boolean value." if !!preserve_formatting != preserve_formatting - raise ArgumentError, "Field text must be a string." if !text.kind_of? String - raise ArgumentError, "Text after must be a string." if !text_after.nil? && (!text_after.kind_of? String) - raise ArgumentError, "Text before must be a string." if !text_before.nil? && (!text_before.kind_of? String) - - @date_time_format = date_time_format - @name = name - @numeric_format = numeric_format - @preserve_formatting = preserve_formatting - @text = text - @text_after = text_after - @text_before = text_before - end - - # Creates an MergeField instance from a hash. - # @param [Hash] hash The hash to try and create an MergeField instance from. - # @return [MergeField] A newly created MergeField instance. - def self.from_camelized_hash(hash) - # Parameter validation - raise ArgumentError, "Parameter must be a Hash." if !hash.kind_of? Hash - - date_time_format = hash["dateTimeFormat"] - name = hash["name"] - numeric_format = hash["numericFormat"] - preserve_formatting = hash["preserveFormatting"] - text = hash["text"] - text_after = hash["textAfter"] - text_before = hash["textBefore"] - return MergeField.new(date_time_format, name, numeric_format, preserve_formatting, text, text_after, text_before) - end - end - end -end \ No newline at end of file diff --git a/lib/txtextcontrol/reportingcloud/merge_settings.rb b/lib/txtextcontrol/reportingcloud/merge_settings.rb deleted file mode 100644 index b43b2fe..0000000 --- a/lib/txtextcontrol/reportingcloud/merge_settings.rb +++ /dev/null @@ -1,69 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require "txtextcontrol/reportingcloud/document_settings" - -module TXTextControl - module ReportingCloud - - # Holds the merge settings needed by the merge method. - # @attr remove_empty_fields [Boolean] Specifies whether empty fields - # should be removed from the template or not. - # @attr remove_empty_blocks [Boolean] Specifies whether the content of - # empty merge blocks should be removed from the template or not. - # @attr remove_empty_images [Boolean] Specifies whether images which - # don't have merge data should be removed from the template or not. - # @attr remove_trailing_whitespace [Boolean] Specifies whether trailing - # whitespace should be removed before saving a document. - # @attr merge_html [Boolean] Specifies whether field data can contain - # formatted Html content or not. The default value is false. Html - # content must be enclosed in an tag element. Only active in - # the Merge endpoint. - # @author Thorsten Kummerow (@thomerow) - class MergeSettings < DocumentSettings - attr_accessor :remove_empty_fields - attr_accessor :remove_empty_blocks - attr_accessor :remove_empty_images - attr_accessor :remove_trailing_whitespace - attr_accessor :merge_html - - alias_method :remove_empty_fields?, :remove_empty_fields - alias_method :remove_empty_blocks?, :remove_empty_blocks - alias_method :remove_empty_images?, :remove_empty_images - alias_method :remove_trailing_whitespace?, :remove_trailing_whitespace - alias_method :merge_html?, :merge_html - - def initialize - @remove_empty_fields = true - @remove_empty_blocks = true - @remove_empty_images = true - @remove_trailing_whitespace = true - @merge_html = false - end - - # Converts a MergeSettings instance to a hash while converting the attribute names - # from snake case to camel case. - # @return [Hash] A hash representing the MergeSettings instance. - def to_camelized_hash - result = { - "removeEmptyFields" => @remove_empty_fields, - "removeEmptyBlocks" => @remove_empty_blocks, - "removeEmptyImages" => @remove_empty_images, - "removeTrailingWhitespace" => @remove_trailing_whitespace, - "mergeHtml" => @merge_html, - } - result.merge(super) - end - end - end -end diff --git a/lib/txtextcontrol/reportingcloud/reportingcloud.rb b/lib/txtextcontrol/reportingcloud/reportingcloud.rb deleted file mode 100644 index 574cef0..0000000 --- a/lib/txtextcontrol/reportingcloud/reportingcloud.rb +++ /dev/null @@ -1,553 +0,0 @@ -# ReportingCloud Ruby SDK -# -# Official Ruby SDK for the ReportingCloud Web API. Authored, maintained and fully supported -# by Text Control GmbH. (http://www.textcontrol.com). -# -# Go to http://www.reporting.cloud to learn more about ReportingCloud -# Go to https://github.com/TextControl/txtextcontrol-reportingcloud-ruby for the -# canonical source repository. -# -# License: https://raw.githubusercontent.com/TextControl/txtextcontrol-reportingcloud-ruby/master/LICENSE.md -# -# Copyright: © 2019 Text Control GmbH - -require "uri" -require "net/http" -require "json" -require "ostruct" -require "cgi" -require 'txtextcontrol/reportingcloud/template' -require 'txtextcontrol/reportingcloud/template_info' -require 'txtextcontrol/reportingcloud/account_settings' -require 'txtextcontrol/reportingcloud/incorrect_word' -require 'txtextcontrol/reportingcloud/find_and_replace_body' -require 'txtextcontrol/reportingcloud/template_name_validator' -require 'txtextcontrol/reportingcloud/template_data_validator' -require 'txtextcontrol/reportingcloud/api_key' -require 'txtextcontrol/reportingcloud/append_body' -require 'core_ext/string' - -module TXTextControl - module ReportingCloud - - # The main class. - # @attr username [String] The user name. - # @attr password [String] The password. - # @attr base_uri [String] The API base url. Is set to "+https://api.reporting.cloud+" - # by default. - # @attr api_version [String] The API version. Is set to "+v1+" by default. - # @attr read_timeout [Integer] The timeout for HTTP requests in seconds. Is set to - # +10+ by default. - # @author Thorsten Kummerow (@thomerow) - class ReportingCloud - attr_accessor :username - attr_accessor :password - attr_accessor :base_uri - attr_accessor :api_version - attr_accessor :read_timeout - - # @param username [String] The user name. - # @param password [String] The password. - # @param base_url [String] The API base url. Is set to "+https://api.reporting.cloud+" - # by default. - def initialize(username, password, base_url = nil) - base_url ||= DEFAULT_BASE_URI - @username = username - @password = password - @api_version = DEFAULT_VERSION - @read_timeout = DEFAULT_TIMEOUT - @base_uri = URI.parse(base_url) - end - - # Lists all templates from the template storage. - # @return [Array