Class: GroupDocs::Signature::Field

Inherits:
Api::Entity show all
Defined in:
lib/groupdocs/signature/field.rb

Defined Under Namespace

Classes: Location

Constant Summary collapse

FIELD_TYPES = 
{
  signature:   1,
  single_line: 2,
  multiline:   3,
  date:        4,
  dropdown:    5,
  checkbox:    6,
}

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Api::Entity

#initialize, #inspect, #to_hash

Constructor Details

This class inherits a constructor from GroupDocs::Api::Entity

Instance Attribute Details

#acceptableValues ⇒ Object Also known as: acceptable_values 



76
77
78
 
# File 'lib/groupdocs/signature/field.rb', line 76

def acceptableValues
  @acceptableValues
end

#defaultValue ⇒ Object Also known as: default_value 



78
79
80
 
# File 'lib/groupdocs/signature/field.rb', line 78

def defaultValue
  @defaultValue
end

#fieldType ⇒ Object 



74
75
76
 
# File 'lib/groupdocs/signature/field.rb', line 74

def fieldType
  @fieldType
end

#fontBold ⇒ Object Also known as: font_bold 



64
65
66
 
# File 'lib/groupdocs/signature/field.rb', line 64

def fontBold
  @fontBold
end

#fontColor ⇒ Object Also known as: font_color 



60
61
62
 
# File 'lib/groupdocs/signature/field.rb', line 60

def fontColor
  @fontColor
end

#fontItalic ⇒ Object Also known as: font_italic 



66
67
68
 
# File 'lib/groupdocs/signature/field.rb', line 66

def fontItalic
  @fontItalic
end

#fontName ⇒ Object Also known as: font_name 



58
59
60
 
# File 'lib/groupdocs/signature/field.rb', line 58

def fontName
  @fontName
end

#fontSize ⇒ Object Also known as: font_size 



62
63
64
 
# File 'lib/groupdocs/signature/field.rb', line 62

def fontSize
  @fontSize
end

#fontUnderline ⇒ Object Also known as: font_underline 



68
69
70
 
# File 'lib/groupdocs/signature/field.rb', line 68

def fontUnderline
  @fontUnderline
end

#getDataFrom ⇒ Object Also known as: get_data_from 



54
55
56
 
# File 'lib/groupdocs/signature/field.rb', line 54

def getDataFrom
  @getDataFrom
end

#graphSizeH ⇒ Object Also known as: graph_size_h, graph_size_height 



52
53
54
 
# File 'lib/groupdocs/signature/field.rb', line 52

def graphSizeH
  @graphSizeH
end

#graphSizeW ⇒ Object Also known as: graph_size_w, graph_size_width 



50
51
52
 
# File 'lib/groupdocs/signature/field.rb', line 50

def graphSizeW
  @graphSizeW
end

#id ⇒ Object 



40
41
42
 
# File 'lib/groupdocs/signature/field.rb', line 40

def id
  @id
end

#input ⇒ Object 



82
83
84
 
# File 'lib/groupdocs/signature/field.rb', line 82

def input
  @input
end

#isSystem ⇒ Object Also known as: is_system 



70
71
72
 
# File 'lib/groupdocs/signature/field.rb', line 70

def isSystem
  @isSystem
end

#location ⇒ Object 



90
91
92
 
# File 'lib/groupdocs/signature/field.rb', line 90

def location
  @location
end

#locations ⇒ Object 



92
93
94
 
# File 'lib/groupdocs/signature/field.rb', line 92

def locations
  @locations
end

#mandatory ⇒ Object 



72
73
74
 
# File 'lib/groupdocs/signature/field.rb', line 72

def mandatory
  @mandatory
end

#name ⇒ Object 



48
49
50
 
# File 'lib/groupdocs/signature/field.rb', line 48

def name
  @name
end

#order ⇒ Object 



84
85
86
 
# File 'lib/groupdocs/signature/field.rb', line 84

def order
  @order
end

#recipientId ⇒ Object Also known as: recipient_id 



44
45
46
 
# File 'lib/groupdocs/signature/field.rb', line 44

def recipientId
  @recipientId
end

#regularExpression ⇒ Object Also known as: regular_expression 



56
57
58
 
# File 'lib/groupdocs/signature/field.rb', line 56

def regularExpression
  @regularExpression
end

#signatureFieldId ⇒ Object Also known as: signature_field_id 



46
47
48
 
# File 'lib/groupdocs/signature/field.rb', line 46

def signatureFieldId
  @signatureFieldId
end

#templateId ⇒ Object Also known as: template_id 



42
43
44
 
# File 'lib/groupdocs/signature/field.rb', line 42

def templateId
  @templateId
end

#textColumns ⇒ Object Also known as: text_columns 



88
89
90
 
# File 'lib/groupdocs/signature/field.rb', line 88

def textColumns
  @textColumns
end

#textRows ⇒ Object Also known as: text_rows 



86
87
88
 
# File 'lib/groupdocs/signature/field.rb', line 86

def textRows
  @textRows
end

#tooltip ⇒ Object 



80
81
82
 
# File 'lib/groupdocs/signature/field.rb', line 80

def tooltip
  @tooltip
end

Class Method Details

.get!(options = {}, access = {}) ⇒ Array<GroupDocs::Signature::Field>

Returns array of predefined lists.

Parameters:

  • options (Hash) (defaults to: {}) —

    Hash of options

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (options):

  • :id (String) —

    Filter by identifier

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/groupdocs/signature/field.rb', line 25

def self.get!(options = {}, access = {})
  api = Api::Request.new do |request|
    request[:access] = access
    request[:method] = :GET
    request[:path] = '/signature/{{client_id}}/fields'
  end
  api.add_params(options)
  json = api.execute!

  json[:fields].map do |field|
    new(field)
  end
end

Instance Method Details

#create!(access = {}) ⇒ Object

Creates signature field.

Examples:

field = GroupDocs::Signature::Field.new
field.name = 'Field'
field.create!

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String) 


201
202
203
204
205
206
207
208
209
210
 
# File 'lib/groupdocs/signature/field.rb', line 201

def create!(access = {})
  json = Api::Request.new do |request|
    request[:access] = access
    request[:method] = :POST
    request[:path] = '/signature/{{client_id}}/field'
    request[:request_body] = to_hash
  end.execute!

  self.id = json[:field][:id]
end

#delete!(access = {}) ⇒ Object

Deletes signature field.

Examples:

Remove all created fields

fields = GroupDocs::Signature::Field.get!.select { |field| !field.is_system }
fields.each { |field| field.delete! }

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String) 


244
245
246
247
248
249
250
 
# File 'lib/groupdocs/signature/field.rb', line 244

def delete!(access = {})
  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :DELETE
    request[:path] = "/signature/{{client_id}}/fields/#{id}"
  end.execute!
end

#field_type ⇒ Symbol Also known as: type

Returns field type in human-readable format.

Returns:

  • (Symbol) 


184
185
186
 
# File 'lib/groupdocs/signature/field.rb', line 184

def field_type
  FIELD_TYPES.invert[@fieldType]
end

#field_type=(type) ⇒ Object Also known as: type=

Saves field type in machine-readable format.

Parameters:

  • type (Symbol, Integer) 


171
172
173
174
175
176
177
 
# File 'lib/groupdocs/signature/field.rb', line 171

def field_type=(type)
  if type.is_a?(Symbol)
    type = FIELD_TYPES[type]
  end

  @fieldType = type
end

#modify!(access = {}) ⇒ Object

Modifies signature field.

Examples:

field = GroupDocs::Signature::Field.get!.first
field.name = 'Field'
field.modify!

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String) 


224
225
226
227
228
229
230
231
 
# File 'lib/groupdocs/signature/field.rb', line 224

def modify!(access = {})
  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :POST
    request[:path] = "/signature/{{client_id}}/fields/#{id}"
    request[:request_body] = to_hash
  end.execute!
end